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COURSE DESCRIPTION 

This course is designed to provide an understanding of the various 
protocols, components, data structures, and algorithms used in 
implementing DECnet-VAX. 

Topics studied include a review of protocols, major software 
components, DECnet data structure analysis, sample traces, and 
tools used for analyzing DECnet data structures and performance. 



INTENDED AUDIENCE 

The intended audience includes: 

• Network programmers 

• Technical support personnel 

• Network managers interested in learning about the 
internals of DECnet-VAX 

PREREQUISITES 

Before enrolling in this course, the student should be familiar 
with: 

• Basic Network Communications Concepts 

• DECnet-VAX Programming and/or DECnet Management 

• VMS Programming 

The Educational Services courses that provide this information are: 

• Programming in DECnet-VAX 

• DECnet Management 

• utilizing VMS Features 
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LIST OF TOPICS 

• A Review of VMS I/O Concepts 

• DIGITAL Network Architecture Layers and Protocols 

• Software Components of DECnet-VAX 

• DECnet-VAX Data Structures 

• Using SDA to Look at DECnet-VAX Data Structures 

• Analysis of Major Network Functions 

• Tracing of Selected Network Flows 

• Performance-Related Parameters 

TOPICS NOT DISCUSSED 

• VMS Internals or Programming 

• VAXcluster, LAT, SNA, PSI Protocols or Internals 

• DECnet Management 
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COURSE GOALS 

Upon completion of this course, students should be able to: 

• Analyze the layers of DIGITAL Network Architecture (DNA) 

• Explain the corresponding protocols of DNA 

• Know the functions and interaction of the major DECnet-VAX 
software components 

• Understand the format and use of DECnet data structures 

• Be able to utilize the SDA utility to look at DECnet data 
structures 

• Be able to trace the actions of major network mechanisms 

• Be able to locate the appropriate code module to trace a 
network operation 

• Understand network parameters related to network 
performance 
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RESOURCES 

*• DECnet-VAX Internals - Student Workbook 

2 * DECnet-V AX Internals - Supplemental Listings - DNA Message 
Formats 

3 * DECnet-VAX Internals - Supplemental Listings - SDL Files 

4. DECnet-VAX Source Listings 

5. VAX/VMS Networking Manual (AA-Y512C-TE) 

6 « VAX/VMS Network Control Program Reference Manual 
(AA-Z425C-TE) ' 

7. Digital's Network - 

An Architecture With a Future (EB-26013-42) 

8 » DECnet DNA (Phase IV) General Description (AA-N149A-TC) 

9. DECnet-DNA NSP Functional Specification, Version 4.0 
(AA-X439A-TK) 

10 • DECnet-DNA Routing Layer Functional Specificatio n, Version 
2.0 (AA-X35A-TK) 

11 • DNA Ethernet Node Product Architecture Specification, 
Version 1.0 (AA-X440A-TK) 

12 • DECnet-DNA Ethernet Data Link Functional Specifications . 
Version 1.0 (AA-Y298A-TK) 

13 • Ethernet Specification , Version 2.0 (AA-K759B-TK) 

14 • DNA Maintenance Operations Functional Specification, 
Version 3.0 ( AA-X436A-TK) 

15 • DNA Network Management Func tional Specification, Version 
4.0 (AA-X437A-TK) L 
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COURSE OUTLINE 

A. REVIEW OF VMS I/O CONCEPTS 

• Virtual Memory 

• 010 processing 

• Device Driver Data Structures 

B. DNA LAYERS AND PROTOCOLS 

• Physical Link Layer 

• Data Link Layer (DDCMP + NI protocol) 

• Routing Layer and Protocol (ROUTING protocol) 

• ECL Layer and Protocol (NSP protocol) 

• Session Control Layer (SC protocol) 

• Network Management Layer (MOP protocol) 

• Network Applications Layer 

• User Layer 

C. MAJOR DECnet COMPONENTS FUNCTIONAL OVERVIEW 

• Data Link Device Drivers 

• NETDRIVER 

• NETACP 

• RMS, DAP Routines, and FAL_n 

• RTTDRIVER, REMACP, and RTPAD 

• Special Processes 

• Objects 

• NDDRIVER 
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• NCP, NML, MOM, MIRROR 

• Other DECnet Components 

D. DECnet-VAX DATA STRUCTURES 

• Overall Data Structure Linkage 

• VMS Data Structures Used by DECnet 

• DECnet-VAX DATA STRUCTURES 

RCB Routing Control Block 

OA Output Adjacency Vector 

ADJ Adjacency Node Database Block 

LPD Logical Path Descriptor 

ICB Internal Connect Block 

LSB Logical Link Subchannel Block 

CNR Configuration Database Root Block 

CNF Configuration Data Block 

XWB Network Window Block 

NDI Remote Node Information 

LNI Local Node Information 

SPI Network Server Process Information 

WQE Work Queue Elements 

NDC Node Counter Block 

Object Information Block (OBI) 

LTB Logical Link Table 

AOA Area Output Adjacency Vector 

CRI Circuit Information 

PLI Physical Line Information 

E. SDA ANALYSIS OF THE MAJOR DECnet DATA STRUCTURES 

• Includes CCB, UCB, XWB, RCB, OA, ADJ, LPD and LTB 
structures 

F. ANALYSIS OF MAJOR DECnet FUNCTIONS 

• Logical Link Creation 

• Routing Table Update 

• Flow Control Mechanisms 

• Message Segmentation 
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G. TRACING OF SELECTED NETWORK FLOWS 

• Flow Diagrams of Major DECnet Actions 

• Connect Initiate and Connect Confirm 

• Transmit and Receiving Normal Data 

• Other DECnet Actions 

H. LOCATING INFORMATION IN LISTINGS 

• Resources required before listing trace 

• Techniques used in listing trace 

• Modules and subroutines that make up the major DECnet 
components 

I. HINTS ON SYSTEM TUNING 

• System and User Buffering 

• Timers 

• Performance-Related Parameters 
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REVIEW OF VMS I/O CONCEPTS 



INTRODUCTION 

DECnet-VAX uses standard input/output (I/O) functions of VMS I/O 
processing. This chapter presents a brief review of VMS I/O 
processing. 

Topics include: 

• Virtual Memory 

• QIO processing 

• Device Driver Data Structures 
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1 VMS MEMORY 



1.1 VMS MEMORY 
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Figure 1-1 Physical Memory Layout 



1-5 



REVIEW OF VMS I/O CONCEPTS 

2 I/O HARDWARE/SOFTWARE INTERRUPTS 

I PL 21 HARDWARE INTERRUPT 

Execute Driver Interrupt Service Routine at IPL 21 
Place itself on IPL 8 Fork Queue 
SOFTINT #UCB$B_FIPL(R5) 
RE I 

IPL 8 SOFTWARE INTERRUPT 

Execute FORK DISPATCHER Interrupt Service Routine 

Dequeue first Fork Block 
Execute Driver IPL Fork Code 

Access shared driver data or 

Suppose I/O completed - need VMS completion code 

Place data block on queue for VMS post 
processing 

SOFTINT #IPL$_IOPOST 

REI 

#IPL$_IOPOST SOFTWARE INTERRUPT- 

Execute I/O POST PROCESSOR Interrupt Service Routine 
Suppose need to access PCB 

Raise IPL to SYNCH level 
Set event flag, queue AST, etc. 
Lower IPL to IPL$_IOPOST 
Possibly initiate SCHEDULER - SOFTINT #IPL$_SCHED 
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DIGITAL NETWORK ARCHITECTURE (DNA) 



INTRODUCTION 

DIGITAL Network Architecture (DNA) is the framework for all DIGITAL 
communications products. DECnet-VAX is one implementation of the 
DNA. 

DNA includes the functional specifications that govern the 
interrelationship of the various software components making up 
DECnet. DNA defines Interfaces and Protocols. 

Interfaces are definitions of specific functional boundaries 
between DECnet software components residing within a single node. 
The boundaries are structured as a hierarchical set of layers with 
DECnet software arranged as modules within these layers. 

Protocols are sets of messages (and rules for exchanging the 
messages) between modules with equivalent functions in the same 
layer, but residing in different nodes. 

Topics include: 

• DECnet Layers and Protocols 

• Functions of each Layer 

• Message Types of each Layer 
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1 DECnet LAYERS AND PROTOCOLS 

• Layers are defined in the DIGITAL Network Architecture 
(DNA) 

• PHASE IV of DNA announced in May, 1982 

• Similar to the International Standards Organization (ISO) 
Open System Interconnect (OSI) Model 

• Each layer is responsible for certain functions logically 
different from those that are supported by another layer 

• Layers communicate across a network by exchanging messages 
according to the rules specified by a corresponding 
protocol 

• A network protocol is a set of formal rules representing a 
layer's logic and communication procedure 

• Protocol is transparent across a network 

• implementation of a layer, as described by a particular 
protocol, is logically transparent in a network 
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DECnet FUNCTION 


DNA LAYER 


DNA PROTOCOLS 


FILE ACCESS 
COMMAND TERMINALS 
HOST SERVICES 
NETWORK CONTROL 
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USER 
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APPLICATION 
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SESSION 
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NETWORK SERVICES 
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ADAPTIVE ROUTING 


ROUTING 


ROUTING PROTOCOL 


HOST SERVICES 

PACKET TRANSMISSION 
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Figure 2-1 DECnet Functions and Related 
DNA Layers and Protocols 
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Table 2-1 DECnet Layers and Protocols 



Layer 



Protocol 



Comments 




User 



Network 
Management 



User-specific Supports user services and programs 






NICE 

MOP 

Event Logger 



Network / 
Application Multiple 

/ <n< 

Session^ ^ 
Control 



User determines the sequence of read 
and/or write operations (Protocol) 



Provides a means to configure, monitor, 
and control the local node and other 
nodes (Privilege is required for some 
of the operations and displays) 



Invokes tasks on behalf of the user 
to perform specific functions 



Performs operating system dependent 
functions 



Mapping node name to address 
Creating processes 
Identifying end-user tasks 
Validating incoming connect requests 






tf> o? .► 



*° 



End 

Communications NSP 



Performs operating system independent 
functions 

Logical link management 
Message segmentation 



Routing 



Routing 



Handles packet routing, congestion 
control, and packet lifetime control 



Data Link 



DDCMP 

Ethernet 

X.25 



Transfers data to physical link layer 



Physical Link 



CI V>\* 
PCL -»" 



Transfers data over physical link 
to adjacent node 






■& .? y ■/ V 












„*? or r <Z 






/9 









2-7 



DIGITAL NETWORK ARCHITECTURE (DNA) 



OSI 



DNA 



V 



\ 



,\ 



\ 



f < 



APPLICATION 




USER 


PRESENTATION 


NETWORK APPLICATIONS 




N M 

E A 

T N 

W A 

G 

R E 

K M 

E 

N 

T 


SESSION 


N-/? 


SESSION CONTROL 


TRANSPORT 


Mr 1 


END COMMUNICATION 


NETWORK 


$/ 


ROUTING 


DATA LINK 




DATA LINK 


PHYSICAL 




PHYSICAL 



MKV87-0567 



Figure 2-2 Layers of DNA vs Layers of OSI 
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B 
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Figure 2-5 Multiple Node Ethernet Network 
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2 Ethernet DATA LINK AND PHYSICAL LINK LAYERS 

• Specification developed jointly by DIGITAL, Intel, and 
XEROX 

• Supported in DECnet PHASE IV 

• Ethernet and IEEE 802.3 LAN standard include a physical 
link layer and data link layer specification 

- Physical link level 

Manchester-encoded, digital baseband signals 

Data link level 

Carrier Sense Multiple Access Collision Detect CSMA/CD 

• Baseband, broadband or "thinwire" cables 

• Transmission capability of 10 MBits 

• Inherently low error rate 

• Local area network 

(<- 2.8 KM (1.74 miles) on baseband) 

(<= 3.8 KM (2.36 miles) on broadband) d«<~H ^ ^^Wv 

• Multiple physical Ethernet LANS may be connected using a 
LAN bridge 

• Multiple node broadcast capabilities 

• Supports up to 1024 nodes per Ethernet LAN 

• Any/all/none of the nodes may/need be a router 
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2.1 Ethernet Addresses and Protocol Types 

• Blocks of- addresses assigned by XEROX Corporation to 
producers of Ethernet interfaces 

• Address field is 48 bits in length 

• Bytes are received and translated into the logical order 
in which they were transmitted (left to right) 

(Bits within the bytes are transmitted from right to left) 

SAMPLE ADDRESS: AA - 01 - 23 - 45 - 67 - FF .4(3 ^ rna 
TRANSMITTED: 1> 2 > 3> 4> 5> 6 

• Ethernet address can be one of three types: 

A. Physical address: 

Unique for every station 

1. Hardware Address - in ROM on controller 

2. Extended DECnet Address - computed using DECnet 

B. BROADCAST ADDRESS: 

To every node on the Ethernet 
FFFFFFFF 

C. MULTICAST ADDRESS: 

Associated with a group of nodes 

DELUA can recognize up to 10 multicast addresses 
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• Physical Address is set to Hardware Address on powerup 

• When DECnet is started on an Ethernet line, the Physical 
Address is overwritten to be the extended DECnet Address 

• Appends DECnet Node Address to constant AA-00-04-00 

• DNA Phase IV Node Addresses are in the range 
AA-00-04-00-00-00 through AA-00-04-00-FF-FF 



■32BITS- 



-16BITS- 



AA - 00 - 04 - 00 



DECnet NODE 
ADDRESS 
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Figure 2-6 Format of Ethernet Physical Address 

To determine the Physical Address of a node: 

1. Convert the Phase IV node address to its decimal 
equivalent using : 

DECnet address = (area-number * 1024) + node-number 

2. Convert the decimal Node Address to its hexadecimal 
equivalent, reversing the order of the bytes 

3. Append the hexadecimal Node Address to AA-00-04-00 

ASSUME DECnet Node Address - 4.171 

(4 * 1024) + 171 = 4096 + 171 

« 4267 (decimal) 

= 10AB (hexadecimal) 

Ethernet Decimal Address = AA-00-04-00-AB-10 
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Table 2-2 Ethernet Protocol Types and Multicast Addresses 



DIGITAL Protocol Types: 



Value Meaning 

60-01 DNA Dump/Load (MOP) 

60-02 DNA Remote Console (MOP) 

60-03 DNA Routing 

60-04 Local Area Transport (LAT) 

60-05 Diagnostics 

60-06 Customer use 

60-07 System Communication Architecture 
(SCA) 



Cross-Company Protocol Type: 



Value Meaning 
90-00 Loopback 



DIGITAL Multicast Addresses: 



Value Meaning 



AB-00-00-01-00-00 DNA Dump/Load Assistance (MOP) 

AB-00-00-02-00-00 DNA Remote Console (MOP) 

AB-00-00-03-00-00 All PHASE IV routers 

AB-00-00-04-00-00 All PHASE IV end nodes 
AB-00-00-05-00-00 thru 

AB-00-03-FF-FF-FF Reserved for future use 

AB-00-03-00-00-00 Local Area Transport (LAT) 
AB-00-04-00-00-00 thru 

AB-00-04-00-FF-FF Customer use 
AB-00-04-01-00-00 thru 

AB-00-04-01-FF-FF System Communication Architecture 

(SCA) 



Cross-Company Multicast Addresses: 



Value Meaning 



FF-FF-FF-FF-FF-FF Broadcast 
CF-00-00-00-00-00 Loopback. Assistance 
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2.2 Ethernet Message Format 

The data encapsulation function of the Data Link Layer comprises 
the construction and processing of frames. The subf unctions of 
framing, addressing, and error detection are reflected in the frame 
format as follows: 

• Framing 

• Addressing 

• Error Detection 
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PHYSICAL/ 
MULTICAST BIT- 



PREAMBLE/ 
START BYTE 



DESTINATION 



SOURCE 



TYPE 



DATA 



FRAME CHECK 



INTERFRAME 
SPACING 



(8 BYTES) 



DESTINATION FRAME 
(6 BYTES) 



SOURCE FRAME 
(6 BYTES) 



TYPE (2 BYTES) 



DATA FIELD 
(46-1500 BYTES) 






>rJ s ) u 



FRAME CHECK SEQUENCE 



(4 BYTES) 



££<L 



(jf" 



\ es^ 



k±o°- 



rl° 



i Mj>t" 



(9.6 MSEC) 
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Figure 2-7 Ethernet Frame Format 
(No Padding - Data >=46 Bytes) 
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PHYSICAL/ 
MULTICAST BIT 



y° 



y 



DESTINATION 



SOURCE 



TYPE 



COUNT 



DATA 



PAD 



FRAME CHECK 



DESTINATION FRAME 
(6 BYTES) 



SOURCE FRAME 
(6 BYTES) 



TYPE (2 BYTES) 
COUNT (2 BYTES) 



DATA FIELD 
(COUNT BYTES) 



PAD (>=0 BYTES TO GET 
44 BYTE DATA+PAD) 



v> 1 






FRAME CHECK SEQUENCE 
(4 BYTES) 
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Figure 2-8 Ethernet Frame Format with Padding 
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PHYSICAL/ 
MULTICAST BIT- 



DESTINATION 



SOURCE 



LENGTH 



DSAP 



SSAP 



CONTROL 



DATA 



FRAME CHECK 



DESTINATION FRAME 
(6 BYTES) 



SOURCE FRAME 
(6 BYTES) 



LENGHTOF FRAME 
(2 BYTES) 

DESTINATION SERVICE ACCESS POINT 
(1 BYTES) 

SOURCE SERVICE ACCESS POINT 
(1 BYTES (1 BYTE) 

UNNUMBERED CONTROL FIELD 
(1 BYTE) 



DATA FIELD 
(43-1 4&7 BYTES) 



■t-i^ 




FRAME CHECK SEQUENCE 
(4 BYTES) 
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Figure 2-9 IEEE 802.3 Packet Format 
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3 DIGITAL DATA COMMUNICATIONS MESSAGE PROTOCOL (DDCMP) 

• Developed by DIGITAL 

• The first Data Link Protocol offered on DECnet 

• A Physical and Data Link Protocol that provides control 
functions on the link between two adjacent nodes only 

• Guarantees error-free sequential delivery of packets 

• Uses sequenced message acknowledgment scheme (CRC-16, 
ACKs, NAKs, request for retransmits) 



Nonbroadcast circuit 
configurations 



point-to-point and multipoint 



Supports normal and maintenance mode 

Isolates higher layers from the physical characteristics 
of the line 

Provides efficiency on channels with long delay times 

Supports a wide variety of channel types 

Implemented both in software (driver) and hardware 
(Controller) 



B 



Figure 2-10 Two Node - 
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Point-to-Point Connection 
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4 DDCMP MESSAGE TYPES 

• Data message (SOH) 

• Control message 

- ACK (pos. acknowledgment) 

- NAK (neg. acknowledgment) 

- REP (repl. for packet req.) 

- STRT (start DDCMP) 

- STACK (STRT ACK) 

• Maintenance message (DLE) 

NOTE 

DDCMP message formats are detailed in the 
Supplemental Listings book. 
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User requests start-up 
R«0,N"0,A-0,T-1,X-0 

> 

STRT Notify user of start-up at 

other station 

User requests start-up 

R«0,N»0,A«0,T»1,X»0 
< 

STRT 
> 

STACK Enter running state 

< 

Enter running state ACK (RESP-0) 

Example 2-1 DDCMP Start-Up Sequence with No Errors 

User requests start-un «y* —//--> SV?^ CCX iC ] ^ >■ ^\ 

^^ SiSTRT \ * 

Time-out ^ I ^ 

> 

STRT Notify user, user requests 

start-up 
< 

STRT ! 
I 

STACK J 

1 Time-out 

< 

STRT 
> 

STACK Enter running mode 

ACK(RESP*0) 

i 

Time-out ! 

> 

STACK 
< 

ACK(RESP-O) 
Enter running state 

Example 2-2 DDCMP Start-Up Sequence with Errors 
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User requests transmit 
R-0 ,N-1 ,A-0 ,T-2 ,X-1 

> 

DATA( NUM«1 , RESP*0 ) 

Message received and given 
to user 

R«l ,N«0 ,A=>0 ,T»1 ,X=0 
< 

ACK(RESP=1) 
User requests transmit 
R»0,N-2,A-1,T»3,X»2 

> 

DATA(NUM«2,RESP=0) Y sC f\^S 

Message received and user ar '\(~ 
requests transmit ^ 

R»2 ,N«1 ,A«0 ,T=2 ,X=1 

< 

DATA( NUM» 1 , RESP= 2 ) 
Message received and user 
requests transmit 
R-l,N«3 f A«2,T=4,X»3 

> 

DATA(NUM-3,RESP-1) 

Message received 
R«3,N»1,A»1,T«2,X»1 
User requests transmit 

R*l ,N»4 , A*2 ,T»5 ,XM 

> 

DATA( NUM-4 ,RESP=1 ) 

Message received 
R-4 ,N»1 , A-l ,T»2 ,X»1 
User requests transmit 
R=4 ,N=2 , A»l ,T=3 ,X=2 

< 

DATA( NUM-2 , RESP=4 ) 
Message received 
R»2 ,N»4 ,A=4 ,T*5 ,X»4 

> 

ACK(RESP»2) 

ACK received 
RM,N»2,A»2,T«3,X»2 

Example 2-3 DDCMP Data Transfer with No Errors 

\"5 



\jUaX. 
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User requests transmit 

R-0,N-1,A«0,T«2,X»1 /--> 

DATA(NUM-1,RESP»0) 

Received in error 

< R«0,N»0,A«0,T«1,X»0 

NAK(RESP-O) 
NAK received 
R-0,N-1,A»0,T-1,X«1 
Retransmit 

R-0,N-1,A-0,T-2,X«1 > 

DATA(NUM-l,RESP-0) 

Message received and 
user requests transmit 

< R»1,N»1,A-0,T-2,X*1 

DATA(NUM«1,RESP»1) 

/-- > 

ACK(RESP»1) 

Queue NAK for R=l 
User requests 3 transmits 

R«1,N»2,A»1,T=3,X«2 > 

DATA(NUM-2,RESP=1) 

Message received 
R=2,N»1,A»1,T=2,X«1 

R»1,N»3,A»1,T-4,X»3 > 

DATA(NUM=3,RESP-1) 

Message received 
R=3,N=1,A»1,T=2,X»1 

R»1,N«4,A=1,T»5,X=4 > 

DATA(NUM=4,RESP»1) 

Message received 
R*4,N=1,A»1,T=2,X»1 

< Queue ACK for R=4 

NAK(RESP-l) Queued NAK returned 
NAK received 
R«1,N-4,A»1,T»2,X»4 
Retransmit 

R»1,N«4,A=1,T»3,X»2 > 

DATA(NUM»2 ,RESP*1 ) 

Message ignored 
< 

ACK{RESP=4) Queued ACK returned 



All messages complete 
R»l ,N*4 , A*4 ,T*5 ,X*2 



Example 2-4 DDCMP Data Transfer with CRC Errors and NAKing 



^ £ 




> % do 
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User requests transmit 
R«0,N»1,A«0,T-2,X«1 



Time-out 



> 

DATA( NUM=1 jRESP-O ) 

I 

1 Message received 

! R=1,N=0,A=0,T=1,X=0 

! 

1 ACK(RESP-l) 

I 

I > 

REP(NUM-l) 

< 

ACK(RESP=1) ACK response to REP 
R»1,N»0,A=0,T=1,X=0 



Time-out 



ACK received 
R"0,H-l,A-l f T-2,X«l 
User requests transmit 
R«0,N«2,A»1,T»3,X=2 

! DATA(NUM=2,RESP=0) 

1 
! 
! 

1 > 

REP(NUM=2) 

< 

NAK(RESP»1) NAK response to REP 
R»1,N=0,A»0,T-1,X=0 

> 

DATA<N0M»2 , RESP*0 ) 

Message received 
R«2,N=0,A=0,T»1,X=0 

< 

ACK(RESP»2) 

ACK received 
R»0,N«2,A=2,T-3,X»2 

Example 2-5 DDCMP Data Transfer with Errors 
Causing Reply Timeouts 
(Sheet 1 of 2) 



NAK received 

R»0,N»2,A-1,T-2,X»2 

Retransmit 

R»0 ,N»2 ,A«1 ,T»3 ,X»2 
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User requests transmit 
R-0,N-3,A»2,T-4,X«3 



User requests transmit 
R-0,N»4,A«2,T=5,X»4 



User requests transmit 
R a 0,N»5,A=2,T=6,X»5 



Time-out 



NAK received 
R«0,N*5,A=3,T»4,X»5 
Retransmit 
R-0,N»5 f A»3,T«5,X=4 



Retransmit 
R a 0,N=5,A«3,T=6,X=5 



All messages complete 
R»0,N»5,A=5,T=6,X»5 



DATA(NUM»3,RESP»0) 



Message received 
R*3,N»0,A»0,T*1,X=0 



DATA(NUM»4 ,RESP»0) 



DATA(NUM=5,RESP=0) 

Message ignored 
R=3,N»0,A=0,T=1,X=0 

// — ACK to received message 
ACK(RESP=3) 



REP(NUM-5) 



NAK(RESP=3) NAK response to REP 
R-3,N-0,A-0,T*l,X-0 



DATA( NUM=4 ,RESP=0 ) 

Message received 
R»4 ,N=0 , A=0 ,T=1 ,X=0 



DATA(NUM»5,RESP=0) 

Message received 
R-5 ,N»0 , A=0 , T=l ,X=0 

ACK(RESP*5) ACK to received messages 



Example 2-5 DDCMP Data Transfer with Errors 
Causing Reply Timeouts 
(Sheet 2 of 2) 



2-26 



DIGITAL NETWORK ARCHITECTURE (DNA) 



5 X.25 DATA LINK AND PHYSICAL LINK PROTOCOL 

• A procedure for delivering packets to a DCE (Data 
Communications Equipment) from a DTE (Data Terminating 
Equipment) 

• Recommendation from CCITT (Coraite Consultatif 
International Telephonique et Telegraphique) for 
interfacing to public packet-switching data networks 

• Contains three levels: 

Level 1 - Physical 
Level 2 - Frame 
Level 3 - Packet 

• The Level 2 (Frame Level) is LAPB (Link Access Protocol 
Balanced) which does link control, error detection and 
retransmission similar to DDCMP 

• DECnet Uses data link mapping technique to incorporate 
x.25 

• X.25 Line Devices: 

- DUP11 

- KMS11 

- KMV11 

- DMF32 (Synchronous Line Unit) 
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5.1 Data Link Mapping 

• Available in nodes with both DECnet and PSI support 

• A DECnet program on one node can communicate by means of 
PSI network to another DECnet program on another node 

• A message already containing routing header is given to 
the X.25 module rather than the DDCMP or Ethernet module 

• The X.25 module puts on the additional x.25 headers (Level 
3 and Level 2) before transmitting it on the PSI network 

• The DECnet node with PSI support on the other side strips 
off the X.25 headers and uses the routing header to 
determine routing 

• The layered architecture enables all of this to take place 
transparently to the user program 
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6 COMPUTER INTERCONNECT (CI) 



yfr 



o proWo^ 



• Supported as a DECnet data link layer protocol between VMS 
nodes 

• CI interface may be used as a DECnet data link 

Uses the CI750 (750), CI780 (SBI Systems), or CIBCI (BI 
Systems) 

• CNDRIVER is the DECnet driver for the CI 
Implemented as a multipoint line 

• DECnet software is independent of cluster software 

• Must have at least one router in a configuration of > 2 
nodes 

Each node with >1 circuit turned on must be a routing node 

• End nodes on the CI cluster can only send to a routing 
node 
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7 DNA ROUTING LAYER 

7.1 Routing Layer Overview 

• Defines the mechanism for routing user data between two 
nonadjacent nodes 

• Provides a "picture" of current network topology and 
determines path a packet will take between two nodes 

• Masks the physical and topological characteristics of the 
network from higher layers 

• DECnet Phase IV supports a network of up to 65000 nodes 

• Routing Terms: 

- Path Length: The number of hops along a path between 

two nodes 

- Circuit Cost: Positive integer value (1-25) 

associated with using a circuit 

- Path Cost: The sum of the circuit costs along a path 

between two nodes 

7.2 Routing Processes and Databases 

A. Decision Process 

B. Forwarding Process 

C. Receive Process 

D. Congestion Control 

E. Packet Lifetime Control 

F. Update Process 

G. Routing Database 

H. Forwarding Database 
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END COMMUNICATION 
LAYER 



ROUTING LAYER 



TRANSMIT 
INTERFACE TO END 
COMMUNICATION 




CONTAINS: 

• REACHABILITY 
VECTOR 

• OUTPUT 
CIRCUIT TO BE 
USED 



FORWARDING PROCESS (^ 

• SUPPLIES AND MANAGES BUFFERS 
FOR ROUTE-THROUGH 

• REJECTS PACKETS FROM END 
COMMUNICATION IF QUEUE 
IS TOO FULL 

• READS FORWARDING DATABASE 
AND DECIDES ON WHICH CIRCUIT 
TO SEND PACKET 

• TAKES CARE OF PACKETS FOR 
UNREACHABLE NODES 

• DROPS INCOMING PACKETS IF THE 
QUEUE IS ALREADY FULL 



RECEIVE INTERFACE 
TO END COMMUNICATION 



DECISION PROCESS /*k 

• SELECTS PATHS W 

• MAINTAINS ROUTING 
. DATABASE 

• MAINTAINS 
FORWARDING 
DATABASE 




CONTAINS: 

• ROUTING 
INFORMATION 
(HOP. COST, 
FLAGS, ETC.) 



RECEIVE PROCESS (^ 

• RECEIVES PACKETS 

• PASSES THEM TO 
APPROPRIATE 
PROCESS 



DISCARDS PACKETS 
THAT HAVE VISITED 
TOO MANY NODES 
(LOOP DETECTION), 



9 



UPDATE PROCESS <?Jj) 

• GENERATES AND 

PROPAGATES ROUTING 
MESSAGES 




O CONTROL SUBLAYE R 

INITIALIZATION SUBLAYER 



DDCMP INITIALIZATION 

• SENDS AND RECEIVES 
INITIALIZATION 
VERIFICATION, AND 
HELLO AND TEST 
MESSAGES 



ETHERNET INITIALIZATION 

• SENDS AND RECEIVES 
ETHERNET ROUTER 
AND ENCODE HELLO 
MESSAGES 

• SELECTS DESIGNATED 
ROUTER 



X.25 INITIALIZATION 
INITIALIZES PVCs 
ISSUES OUTGOING AND 
ACCEPTS INCOMING 
CALLS 

BLOCKS, DEBLOCKS, 
FRAGMENTS, AND 
REASSEMBLES 
PACKETS ffi 



DATA LINK LAYER 



DDCMP MODULE 



ETHERNET MODULE 




CONTAINS: 
• CIRCUIT 
MAPPING 
DATA 



X.25 LEVEL 3 MODULE 



MKV87-0576 



Figure 2-11 Routing Layer Components 
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7.2.1 Decision Process 

• Selects routes to each destination in the network 

• Consists of: 

- A connectivity algorithm that maintains path lengths 

- A traffic assignment algorithm that maintains path 
costs 

• Receiving a routing message from an adjacent node causes 
the /routing node to execute the decision process 

• This results in the determination of: 

- <CIRCUIT r NEIGHBOR> pairs (known as adjacencies) along 
which to forward packets 

- Conclusions that a particular destination node is 
reachable or unreachable 

• Parameters in the routing database that the decision 
process uses: 

Maximum address 

Maximum cost 

Maximum hops 

Maximum circuits 

Circuit costs 

Maximum broadcast routers 

Maximum broadcast nonrouters 

Maximum area (for area routers) 

Area maximum hops (for area routers) 

Area maximum cost (for area routers) 
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LEGEND: 







-NODE 
= CIRCUIT 
HOP 



EH3 

N = CIRCUIT COST 



NODE A WANTS TO SEND A PACKET TO NODE D (THREE POSSIBLE PATHS) 


PATH 


PATH COST 


PATH 
LENGTH 


EH3.H-0.EH3 


2 + 2 + 3 = 7* 


3 HOPS 


EH3.EH3 


2 + 7 = 9 


2 HOPS 


EH3, EHD, EHD, B-0 


2 + 3 + 4 + 2 = 11 


4 HOPS 



*7 IS THE LOWEST PATH COST; NODE A THEREFORE ROUTES 
THE PACKET TO NODE D VIA THIS PATH. 



Figure 2-12 Routing Overview 
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7.2.2 Forwarding Process 

• Manages the buffers necessary to support packet route- 
through to all destinations 

• Performs a table lookup to determine the output adjacency 
to use for forwarding to a given destination 

• Strips off the area fields when forwarding to a Phase in 
node 

• Fills in the area fields when receiving from a PHASE III 
node 

• Marks Intra-Ethernet packets 

7.2.3 Receive Process 

• Inspects a packet's route header 

• Dispatches the packet to an appropriate routing layer 
control component or to the End Communications Layer (ECL) 

7.2.4 Congestion Control 

• Manages buffers by limiting the maximum number of packets 
on the transmit queue for a circuit 

• Regulates the ratio of packets received directly from ECL 
to route-through packets 

• Checks the packet size for each packet to be sent 
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7.2.5 Packet Lifetime Control 

The packet lifetime control component requires three processes: 

• Loop Detector 

- Process prevents excessive packet looping 

- Counts the number of nodes a packet has visited and 
removes a packet when it exceeds MAX Visits 

• Node Listener and Node Talker 

- Places an artificial load on the adjacency so failures 
can be detected 

- Provides for detection of adjacent routing layer halt 
and adjacent node identity change 

Uses parameters 

Hello Timer 
Listen Timer 
Routing Timer 
Broadcast Routing Timer 

7.2.6 Update Process 

NOTE 

The Routing Layer Update Process is covered in 
Module 6, Section 4. 
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7.3 Routing Protocol Message Types 

A. Packet Routing Header 

Used for data messages. 

Routing data packets are headers that prefix the 
information that comes from the higher layer (End 
Communications) . 

Header information has the source and destination node 
addresses, a visit count field, and a route flag. 

B. Routing Message 

Provides information necessary for updating the routing 
database of an adjacent node. 

Segmented routing messages are used. Each segment 
consists of a count, a start node ID followed by the 
minimum hop, and minimum cost information. 

C. Ethernet Routing Node Hello Message 

Used for initialization and periodic monitoring of routers 
on an Ethernet circuit. 

Sent from routers to other routers and to end nodes. Used 
in selecting Designated Router on the Ethernet. 

D. Ethernet End Node Hello Message 

Used for initialization and periodic monitoring of end 
nodes on an Ethernet circuit. 

Sent from end nodes to routers on the Ethernet. 
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E. Hello & Test 

Tests an adjacent node to determine if an adjacency is 
operational. 

F. Initialization 

G. Verification 



NOTE 

Routing layer message formats are detailed in the 
Supplemental Listings book. 
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7.4 Routing Layer Initialization Examples 



7.4.1 Routing Node to Routing Node on Nonbroadcast Circuit 
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Phase IV Routing Node A j<> Phase IV Routing Node B 



Routing Init. Message v ^ 



(Optional Verification 
Message) 



Segmented Routing 
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7.4.2 Routing Node (Node A) Coming Up on the Ethernet 

1. Node A multicasts the Router Hello Message to all Routers. 

2. The routers update their databases to include Routing Node 
A. 

Each router also tries to work out who should be the 
Designated Router. The decision is based on the router 
priority from the Router Hello Message. The router with 
the highest priority will be the Designated Router. The 
highest node address breaks ties. 

The Designated Router periodically multicasts the Router 
Hello Message to all end nodes. Node A may or may not be 
the Designated Router. 

3. Node A learns about the end nodes from the End Node Hello 
Messages and about the routing nodes from the Router Hello 
Messages. 

4. Due to resource constraints, there should only be a 
limited number of routers on an Ethernet. 
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7.4.3 Ethernet End Node Support 

• End nodes do not listen to routing messages 

• No network state kept 

• On non-Ethernet circuits, end nodes must consult with the 
router to find out if a node is reachable and must route 
all traffic through the router 

• On Ethernet, end nodes perform end node caching 

NOTE 

The result of this cache is that the first message 
to a remote node must be routed through the 
Designated Router; all subsequent messages are sent 
directly to the node over the Ethernet. 
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7.4.4 Nonrouting Node (Node X) Coming Up on Ethernet 

1. Node X raulticasts the End Node Hello Message to all 
routers. This is repeated periodically to prevent 
corruption of the routing database due to messages loss 
over the NI. 

2. The routers update their databases to include the 
nonrouting Node X. 

The routers multicast the Router Hello Messages 
periodically to all routers. 

The Designated Router (the one with highest router 
priority or highest address) additionally multicasts the 
Router Hello Message to all nonrouting or end nodes. 

3. The Nonrouting Node X stores the information about this 
Designated Router. 

4. When the nonrouting Node X wants to communicate with 
another Node Y, it does the following: 

a. Checks if information about Node Y is already in 
cache. If so, Node X addresses Node Y directly 
(Concept of node adjacency). 

b. If no information is in cache, Node X addresses the 
Designated Router to route the message to Node Y. 

c. If there is no Designated Router, Node X addresses 
Node Y directly. 

5. On Node X, if a packet is received from Node Z with the 
on-Ethernet bit set within the routing header, Node Z's 
address can be stored in cache and packets can be sent to 
Node Z directly without going through the Designated 
Router. 
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8 END-TO-END COMMUNICATIONS LAYER 

8.1 Functions of the End-to-End Communictions Layer 

• Handles the Operating System Independent aspects of 
communications 

• Creates, maintains, and destroys logical links 

• Manages the movement of normal and interrupt data 

• Breaks up user messages into segments 

• Guarantees the delivery of data and control messages to a 
specified destination by means of an error control 
mechanism 

• Some key concepts to know are: 

- Logical link 
Interrupt and normal data 

- Message sequencing and acknowledgment 
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Flow control 

Mechanism to determine when to send interrupt and 
normal data. 

During logical link formation, the NSP at each end of 
the link determines the kind of flow control it 
expects when acting as a data receiver. The term 
"data-receiving NSP" means an NSP acting as a data 
receiver. 

The types of flow control available to NSP are: 

1. NO FLOW CONTROL 

2. SEGMENT FLOW CONTROL (REQUEST COUNT) 

3. MESSAGE FLOW CONTROL 



NOTE 

1. When NO FLOW CONTROL is specified, DECnet 
uses an ON/OFF control mechanism. 

2. ON/OFF may also be used with SEGMENT FLOW 
CONTROL. 

3. MESSAGE FLOW CONTROL is being phased out. 

4. NSP flow control mechanisms are detailed 
in Module 6, Section 2. 
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8.2 ECL - Network Services Protocol (NSP) Message Types 

A* DATA SEGMENT 

Carries a portion of a Session Control message 

B. INTERRUPT DATA (OTHER DATA) 

Carries urgent data, originating from higher DNA layers, 
and optionally a Data Segment acknowledgment 

C. DATA REQUEST 

Carries data flow control information, and optionally a 
Data Segment acknowledgment 

c cxS D. INTERRUPT REQUEST 

crLf vA. Carries interrupt flow control information, and optionally 
v Jr " a Data Segment acknowledgment 

E. DATA ACKNOWLEDGMENT 

Acknowledges receipt of either a Connect Confirm or one or 
more Data Segment messages, and optionally another 
interrupt message 

F. OTHER DATA ACKNOWLEDGMENT 

Acknowledges receipt of either one or more Interrupt, Data 
Request or Interrupt Request messages, and optionally a 
Data Segment message 

G. CONNECT ACKNOWLEDGMENT 

Acknowledges receipt of a Connect Initiate message 

H. CONNECT INITIATE 

Carries a logical link connect request from a Session 
Control Module 
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I. CONNECT CONFIRM 

Carries a logical link connect acceptance from a Session 
Control Module 

J. DISCONNECT INITIATE 

Carries a logical link connect rejection or disconnect 
request from a Session Control Module 

K. NO RESOURCE (DISCONNECT CONFIRM) 

Sent when a Connect Initiate message is received and there 
are no resources to establish a new logical link 

L. DISCONNECT COMPLETE (DISCONNECT CONFIRM) 

Acknowledges the receipt of a Disconnect Initiate message 

M. NO LINK (DISCONNECT CONFIRM) 

Sent when a message is received for a nonexistent logical 
link 

N. NO OPERATION 

Does nothing 



NOTE 

NSP message formats are detailed in the 
Supplemental Listings book. 
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9 SESSION CONTROL LAYER 

9.1 Functions of the Session Control Layer 

• Acts together with the end communication layer to create 
and maintain logical links 

• Performs the Operating System Dependent functions s 

- Maps node names to node addresses 

- Identifies end-user tasks using an operating system 
dependent algorithm 

- Creates or activates processes 

- Validates incoming connect requests 

- Sends and receives logical link requests 

- Disconnects and aborts logical links 

NOTE 

For logical link requests, disconnects 
and aborts: 

• When a request comes from an 
end-user process, it is passed 
directly to ECL. 

• When a notification comes from 
ECL, it is passed directly to the 
end-user process. 
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9.2 Session Control Protocol Message Types 

No separate protocol header is added for session control 
messages. 

Session control uses the CONNECT INITIATE and DISCONNECT 
message fields of the end communication messages. 

A. CONNECT data 

B. REJECT data 

C. DISCONNECT data 

NOTE 

Session control message formats are detailed in 
the Supplemental Listings book. 
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10 NETWORK APPLICATIONS LAYER 
10.1 Data Access Protocol (DAP) 

• Uses local RMS 

• Communicates with remote PAL 

• Retrieves input files and creates output files 

• Provides file transportability between nodes 

• Provides error recovery 

• Allows multiple data streams over a logical link 

• Provides command file execution and submission 

• Provides random access of records in a file 

• Provides file deletion 

• Provides directory listings 
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10.1.1 DAP Message Types 

A. Configuration 

B. Attributes 

C. Access 

D. Control 

E. Continue-Transfer 

F. Acknowledge 

G. Access Complete 
H. Data 

I. Status 

J. Key Definition Attributes Extension 

K. Allocation Attributes Extension 

L. Summary Attributes Extension 

M. Date and Time Attributes Extension 

N. Protection Attributes Extension 

0. Name 
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SOURCE NODE 



MESSAGES 



TARGET NODE 



CONFIGURATION INFO 
(Buffer Size, OS, File 
System, DECnet/DAP 
Version) 



FILE CHARACTERISITCS 
(File Type, Record 
Size & Attributes) 

Access Request 



SET UP DATA STREAM 



CONFIGURATION 
MESSAGE ■-■■■■«> 

CONFIGURATION 
<"««»" MESSAGE 



ATTRIBUTE 
MESSAGE «««-> 



ACCESS MESSAGE — — »-> 

ATTRIBUTE 
<======= MESSAGE 

ACKNOWLEDGEMENT 
<===«== MESSAGE 

CONTROL (Initiate Data 
Stream) MESSAGE ■■■■■■■> 



CONFIGURATION INFO 
RETURNED 



ACTUAL FILE 

CHARACTERISTICS 

RETURNED 

FILE OPENED 



REQUEST START OF 
DATA TRANSFER 



REQUEST TO TERMINATE 
FILE TRANSFER 



ACKNOWLEDGEMENT 
<======= MESSAGE 

CONTROL (Get) 

MESSAGE »«««»: 

Record 1 

Record n 
< 33S »* 3 STATUS MESSAGE 

ACCESS COMPLETE 
MESSAGE »«=====> 

ACCESS COMPLETE 
<======= RESPONSE 



DATA STREAM 
ESTABLISHED 



DATA SENT IN 
RECORDS 



EOF DETECTED 



REQUEST COMPLETED 
SUCCESSFULLY 



Example 2-6 DAP Message Exchange (Sequential File Access) 
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10.2 Other Network Applications Protocols 

1. Command Terminal (CTERM) 
SET HOST 

2. SNA (Systems Network Architecture) 
Access to IBM SNA Networks 

SNA Capabilities 

- DECnet/SNA Remote Job Entry (RJE) 

- DECnet/SNA 3270 Terminal Emulator (3270 TE) 

- DECnet/SNA Distributed Host Command Facility (DHCF) 

- DECnet/SNA DISOSS Document Exchange Facility (DDXF) 

- DECnet/SNA Printer Emulator (PrE) 
DECnet/SNA Application Interface (AI) 
External Document Exchange (EDE) with IBM DISOSS 

Access to common DISOSS/370 database 

Complete access to Document Content Architecture 
(DCA) documents 

Edit and conversion utilities 

Accessible through ALL-IN-1, WPS-PLUS or DECmates 

3. PSI-ACCESS - Access to Packet-Switching Data Network 
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4. Loopback Mirror Protocol 

• Handles node loopback functions 

• Message types 

A. Command 

Request a loop test and send the data to be looped 

B. RESPONSE 

Return status information and the loopedback data 
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11 NETWORK MANAGEMENT LAYER 

• Provides facility to oversee, test, monitor, and control 
the network 

• Allows an end-user to access local and remote databases, 
images, etc. for various network management functions 
using NCP (Network Control Program) 

• Has direct access to each of the lower layers for control 
purposes 

• Functions include: 

Examining the configuration status 
Examining the network parameters 

- Changing the parameters (such as those for node, line, 
circuit, logging) 

- Changing the network configuration and modifying 
message traffic patterns 

- Downline loading remote systems 

- Upline dumping of remote systems 

- Examining performance variables 
Providing loopback tests for fault isolation 

• Supports Multiple Protocols: 

- NICE - Network Information and Control Exchange 

- MOP - Maintenance Operations Protocol 
Event Logging Protocol 
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11.1 NICE Protocol 

• Handles most functions of the network management layer 

• NML (Network Management Listener) uses NICE protocol to 
monitor status and activity of remote nodes 

• Request and Response Message Types: 

A. Request downline load 

B. Request upline dump 

C. Trigger bootstrap 

D. Test 

E. Change parameter 

F. Read information 

G. Zero counters 

H. System-specific functions 
I. NICE response message 

NOTE 

NICE Message Formats are detailed in the 
Supplemental Listings book. 
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11.2 Maintenance Operation Protocol (MOP) Functions 

• Functions do not require the services of any layers other 
than the network management and data link layers 

• Downline loading 

• Upline dumping 

• Loopback testing 

• Force entry into MOP mode 

• Passes transfer addresses so that programs resident in 
memory will execute 

• System console control for remote and/or unattended nodes 
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1. The target node transmits a REQUEST PROGRAM message to the 
LOAD ASSISTANCE multicast address (AB-00-00-01-00-00) - i.e., 
a request for any host. 

2. The hosts check their own databases to see if they can 
downline load the target. 

3. If so, they send the secondary bootstrap code. This message 
is addressed to the 48-bit address in the header of the 
REQUEST PROGRAM message. 

4. The first host to respond is chosen by the target to continue 
the loading sequence. No message is returned to any other 
host. 

5. The loading sequence continues with the tertiary loader. The 
tertiary loader will be sent in separate messages with a 
maximum of 1500 bytes per message (Ethernet limitation). 

6. The tertiary loader in the target then requests the host for 
the operating system. The operating system will be sent in 
separate messages. The last segment is followed by a 
PARAMETER LOAD WITH TRANSFER ADDRESS message, which sets up 
extra values for the node identification and the host 
identification, in addition to the start address of the image 
just loaded. 

Example 2-7 Downline Loading on Ethernet 
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DECnet event 0.3, automatic line service 

From node 1.1 (CANADA), 04-JUL-1986 17:37:07.46 

Circuit UNA-0, Load, Requested, Node =1.9 (SNAP) 

Pile = PLUT02.SYS, secondary loader, 

Ethernet address = 08-00-2B-02-8F-B1 



DECnet event 0.3, automatic line service 

From node 1.1 (CANADA), 04-JUL-1986 17:37:07.56 

Circuit UNA-0, Load, Successful, Node = 1.9 (SNAP) 

File = PLUT02.SYS, Secondary loader, 

Ethernet address = 08-00-2B-02-8F-B1 



DECnet event 0.3, automatic line service 

From node 1.1 (CANADA), 04-JUL-1986 17:37:07.66 

Circuit UNA-0, Load, Requested, Node =1.9 (SNAP) 

File = PLUT03.SYS, Tertiary loader, 

Ethernet address = 08-00-2B-02-8F-B1 



DECnet event 0.3, automatic line service 

From node 1.1 (CANADA), 04-JUL-1986 17:37:08.99 

Circuit UNA-0, Load, Successful, Node = 1.9 (SNAP) 

File = PLUT03.SYS, Tertiary loader, 

Ethernet address = 08-00-2B-02-8F-B1 



DECnet event 0.3, automatic line service 

From node 1.1 (CANADA), 04-JUL-1986 17:37:09.10 

Circuit UNA-0, Load, Requested, Node =1.9 (SNAP) 

File = SYS$SYSROOT: [PLUTO] SNAPTSV. SYS, Operating system 

Ethernet address = 08-00-2B-02-8F-B1 



DECnet event 0.3, automatic line service 
From node 1.1 (CANADA), 04-JUL-1986 17:37:15.21 
Circuit UNA-0, Load, Successful, Node =1.9 (SNAP) 
File = SYS$SYSROOT: [PLUTO] SNAPTSV. SYS, Operating system 
Ethernet address = 08-00-2B-02-8F-B1 



Example 2-8 EVL Messages for Downline Load 
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11.3 Event Logger Protocol 

• Records significant events 

• Event logs help monitor network activity and problems 

• Uses only one message - the event message 

• Provides information about: 

- The node at which the event is to be logged 

- Where event is to be logged (console, file, monitor) 
Event type and class 

Date and time 

Name and address of source node 

- Whether the event relates to a DECnet module, node, 
circuit, or line 

- Specific data concerning the event 
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12 THE USER LAYER 

• The highest layer of DNA 

• Supports user services and programs 

• The user interface for DECnet-VAX is very simple 

$ TYPE node: tdisk: [directory] filename. type 

• The user decides on the protocol used 

The sequence of reads and writes in a task-to-task 
communication 
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DECnet-VAX SOFTWARE COMPONENTS 

INTRODUCTION 

This chapter discusses the software components of DECnet-VAX. 
Topics include: 

• Data Link Device Drivers 

- XMDRIVER 

- XDDRIVER 

- XGDRIVER 

- ETDRIVER 

- XEDRIVER 

- XQDRIVER 

- CNDRIVER 

- NODRIVER 

- NWDRIVER 

• NETDRIVER 

• NETACP 

• RMS, DAP Routines, and FAL_n 

• RTTDRIVER, REMACP, and RTPAD 

• Special Processes 

- NETSERVER 

- MOM 

• Objects 

- FAL 

- NML 

- EVL 

- MIRROR 

- DTR 

- MAIL 

- PHONE 

- HLD 

• NDDRIVER 

• Other DECnet Components 

Permanent configuration database 

- Volatile configuration database 

- NCP 

- SYS$MANAGER: STARTNET.COM 
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1 DATA LINK DEVICE DRIVERS 

1.1 XMDRIVER 

Device driver for the DDCMP microcode devices such as DMC11 or 
DMR11. The same driver is used for both the DMC and the DMR. 

1.2 XDDRIVER 

Device driver for the DMP11 interface. The DMP11 contains DDCMP 
microcode to handle multipoint. 

1.3 XGDRIVER 

Device driver for the DMF32 synchronous port interface. Uses 
software implementation of DDCMP. 

1.4 ETDRIVER 

Device driver for DIGITAL Ethernet BI Network Adapter (DEBNT). 

^f 1.5 XEDRIVER 

* 'X Device driver for DIGITAL Ethernet UNIBUS Adapter (DEUNA and 
o v o^ DELUA). 

| ¥V tf The Ethernet data link is done in the microcode of the controller 
« (DEUNA, DELUA). 



*-> 



1.6 XQDRIVER 

Device driver for DIGITAL Ethernet Q-Bus Adapter (DEQNA) . 

1.7 CNDRIVER 

Device driver for Computer Interconnect (CI). This driver is 
similar to the DMP11 driver and is used in local, multipoint, and 
high-speed environments* 

1.8 NWDRIVER - For X.25 (Used for Datalink Mapping) ^ ° q ° 
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1.9 NODRIVER 



Device driver for asynchronous DECnet (DDCMP protocol). This 
driver can be used with any VMS-supported terminal driver. 

2 NETDRIVER 

• Implements routing, end communications, and session 
control layers 

• Handles the time-critical code 

(Data transfers, mailbox message delivery, interrupt 
message handling, protocol, ACKs/NAKs, retransmissions) 

• Handles the network QIO interface 

• Passes control to NETACP to handle nontime-critical code 
or code that requires process context 

Information passed by means of its mailbox or the ACP 
Queue Blocks (AQB) 

- NETACP is awakened to handle the request 

- NETACP may requeue the IRPs back to NETDRIVER and call 
its routines directly 

• Has standard VAX/VMS device driver format and data 
structures 

• The hardware interrupt code is missing 

• The interface from NETDRIVER to the DATA LINK drivers is 
by means of internal QIOs 
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3 NETACP 



• Implements routing, end communications, and session 
control layers 

• Handles the nontime-critical code and code that requires 
process context for the network 

Connects, disconnects, line and circuit state transitions, 
volatile database maintenance, and routing updates 

• Sets up the routing database in nonpaged pool (so 
NETDRIVER can access it) 

The volatile database is kept in paged memory 

• Implemented as a process 

• Hibernates when there is nothing to do 

• Can be awakened by a mailbox AST or by a wake up request 
from the VMS executive 

• IT scans one of its three queues: 

1. Timer Queue — containing routing timers, inactivity 
timers 

2. Work Queue — containing work queue elements from 
NETDRIVER 

3. CP Queue (AQB) — containing IRPs for connect initiate 

• If there is something to do, it dispatches to one of the 
processing routines and returns to the dispatch or 
hibernate loop when done 
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4 RMS, DAP ROUTINES, AND FAL_N 

• Implement application layer for file transfer operations 

• For normal user tasks requesting access to a file (i.e., 
OPEN, TYPE, DIRECTORY , etc.), the request will be passed 
to RMS 

• When RMS detects the network file specifier ("::"), it 
knows that remote node access is needed, and sets up the 
appropriate $QIO 

• The $QI0 specifies the remote task and requests that the 
logical link be set up on behalf of the user task 

• The interface between RMS and NETDRIVER is by means of 
Network QIOs 

(RMS is simply treated as any other DECnet user) 



5 RTTDRIVER, REMACP, AND RTPAD 

• Implement application layer for remote terminal access 
(SET HOST) 

• Uses the command terminal (CTERM) protocol 
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6 SPECIAL PROCESSES 

6.1 NETSERVER 

• The mechanism used to start a network user process on a 
remote node and select the task to execute 

• Allows single process to service multiple logical links 

• Keeps SERVER_n processes around (for NETSERVBR$TIMEOUT) 
waiting for Tnbound connect requests 

• Created by NETACP and receives logical link requests by 
means of special QIO interface 

• Selects the task to execute VIA LIB$DO_COMMAND OR 
LI B$ RUN_PROGRAM 

6.2 MOM 

• Maintenance operation modules used for maintenance 
operations such as downline load, upline dump, and 
loopback test 

• NML spawns a MOM process which interacts with the 
NDDRIVER, or an incoming request can cause NETACP to 
create a MOM process 
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7 OBJECTS 
7.1 FAL 

• File Access Listener for remote file access 



7.2 NML 



7.3 EVL 



Network management listener that manipulates permanent and 
volatile (by means of NETACP) configuration databases 



Event logger that collects network events from nonpaged 
pool, filters and passes them to the correct destination 



7.4 MIRROR 

• Loopback mirror program used in loopback tests 

7.5 DTR 

• Data receiver that interacts with the DTSEND program to 
check out and provide statistics on task-to-task 
communication 

7.6 MAIL 

• VAX/VMS Electronic mail utility 

7.7 PHONE 

• VAX/VMS phone utility 

7.8 HLD 

• Host task loader that interacts with the satellite task 
loader (sld) to downline load RSX-11S tasks 
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8 NDDRIVER 



• This driver handles the direct line access functions on 
behalf of MOM process 

• Passes control to NETACP for some non-time-critical code 

• For Nonbroadcast Circuits: 

- The data link driver such as XMDRIVER passes control 
to NETDRIVER when a packet has been received 

If the packet happens to be a MOP request function, 
NETDRIVER informs NETACP 

- The outstanding I/O on that UCB is aborted and NETACP 
gives control of the UCB to the NDDRIVER 

• For Broadcast Circuits (e.g., Ethernet): 

- The data link driver (XEDRIVER) has multiple UCBs that 
are distinguished by their protocol type. The driver 
checks the protocol type of the packet. 

If the protocol type is DECnet (60-03), the packet is 
passed to NETDRIVER. 

- If the protocol type is MOP (60-01), the UCB is set up 
for maintenance operation. 

For a new request, NETACP is activated and creates a 
MOM process to handle this new request. 

The MOM process uses the NDDRIVER to handle the 
request. 
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9 OTHER DECnet COMPONENTS 

9.1 Permanent Configuration Database 

• Files that define the network as known to the local node 

- SYS$ SYSTEM: NETCIRC.DAT \ x ^£j^P 

- SYS$SYSTEM: NETCONF.DAT j W>'^ 

- SYS$ SYSTEM: NETLINE.DAT / ^ ] 

- SYS$SYSTEM: NETLOGING.DAT L^ 

- SYS$ SYSTEM iNETOBJECT.DAT /S c |xvnt^^ 

- SYS$SYSTEM: NETNODE_LOCAL.DAT ( ' € ** > e 

- SYS$ SYSTEM: NETNODE_REMOTE.DAT V <-^ n0 "^ 

• Provides initial values for network parameters 

• Loaded to volatile database in memory when the network is 
started 

• Initially configured with SYS$MANAGER:NETCONFIG.COM 

• Modify with the NCP commands DEFINE | LIST | PURGE 

9.2 Volatile Configuration Database 

• Resides in memory in NETACP process space 

• Contains the specific parameters used by layers of DECnet 

• Modify with the NCP commands SET| SHOW | CLEAR | ZERO 
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9.3 NCP 

• Network Control Program that interacts with NML to control 
and monitor the network 

9.4 SYS$MANAGER:STARTNET.COM 

• Command procedure to start the network 



aVo^ 



Calls L0ADNET.COM to load NETDRIVER and start the NETACP 
process 



( ^ v\<£ . • Calls RTTL0AD.COM to load RTTDRIVER and run the REMACP 



V 



Oi 



A V^^rXP 



^\c\o°^ process ^ ^W ^^t \^rt ^\\4;i\ ^w«^ 



^ 



• Calls STARTPSI.COM to configure PSI 

• Configures the basic volatile database 

• Sets up the node database (NCP> SET KNOWN NODES ALL) 
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DECnet-VAX DATA STRUCTURES 

INTRODUCTION 

This chapter reviews DECnet data structures and their format. 

Topics include: 

• Overall Data Structure Linkage 

• Major VMS Device Driver Data Structures Used by DECnet 

- Unit Control Block (UCB) 

- Device Data Block (DDB) 

- Channel Request Block (CRB) 

- Interrupt Data Block (IDB) 

- Adapter Control Block (ADP) 

- Channel Control Block (CCB) 

- I/O Request Packet (IRP) 

• DECnet-Specif ic Data Structures 

- Routing Control Block (RCB) 

- Output Adjacency (OA) and Area Output Adjacency (AOA) 

- Adjacency Node Database Block (ADJ) 

- Logical Path Descriptor (LPD) 
Internal Connect Block (ICB) 

- Logical Link Subchannel Block (LSB) 

- Configuration Data Root Block (CNR) and Data Block 
(CNF) 

- Network Window Block (XWB) 

- Remote Node (NDI) and Local Node Information (LNI) 

- Network Server Process Information (SPI) 

- Work Queue Elements (WQE) 

- Node Counter Block (NDC) 
Event Logger Data Structures 

- Object Information Block (OBI) 

- Circuit (CRI) and Physical Line Information (PLI) 



4-3 



^ 



\p 4 



^ 



o> 



V 



<? 



.-/V 



DEC net- VAX DATA STRUCTURES 



CCB 




UCB(MBDRIVER) 


CCB$L_UCB 









CCB 



UCB (NETDRIVER) 



CCB$L_UCB 
CCB$L_WIND 



UCB$L_AMB 
UCB$L VCB 



XWB 



XWB$L_ORGUCB 



RCB 



RCB$L_PTR_AOA 

RCB$L_PTR_OA 

RCB$L_PTR_ADJ 
RCB$L_PTR_LPD 
RCB$L_PTR_LTB 

RCB$L PTR NDC 



AOA 



OA 



OFFSET TO 
ADJ (@2B) 



ADJ 



ADJSB LPD INX 



LPD 



LPD$L UCB *J 



LTB 



LTB$L XWB 



NDC 
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Figure 4-1 Overall Data Structure Linkage 



4-4 



DECnet-VAX DATA STRUCTURES 



1 MAJOR VMS DATA STRUCTURES USED BY DECnet 

The interface of DECnet to VAX is by means of the QIO. Therefore, 
data structures in VMS relating to QIO processing will be involved. 
Their formats are defined in SYSDEF.STB. The main VMS 10 data 
structures are the Unit Control Block (UCB), Device Data Block 
(DDB), Channel Request Block (CRB) , Interrupt Data Block (IDB) f 
Adapter Control Block (ADP), Channel Control Block (CCB), and I/O 
Request Packet (IRP). 



1.1 Unit Control Block (UCB) 



Describes characteristics and current state of a specific 
unit 

The UCB is linked to the rest of the I/O data structures 
and contains information such as listheads for the pending 
I/O request packets 

Contains the fork block of the fork process executing code 
to perform I/O on this unit 

The UCB, together with the network window block (XWB) , can 
be considered the focal point of the I/O database for 
DECnet 

UCBs of interest to DECnet are those for NETDRIVER, the 
datalink drivers, and MBDRIVER 
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1.1.1 UCB Fields 









&P< 



t o^-_^v 



a 



,o 



^ 



gpO 



UCB$K__Length - Length of standard UCB 

UCB$L_FQFL - Fork queue forward link 

UCB$L_FQBL - Fork queue backward link 

UCB$L_RQBL - NET — RCV queue backward link 

UCB$W__SIZE - Size of UCB in bytes 

UCB$BTYPE - Structure type for UCB 

UCB$B_FIPL - Fork interrupt priority level 

UCB$T_PARTNER - NET — Partner's nodename 

UCB$L_FIRST - NET — ADDR of first seg of chained MSG 

UCB$W_BUFQUO - Buffered I/O quota charged for this UCB 

UCB$W_DSTADDR - NET — remote connect number 

UCB$W_SRCADDR - NET — local connect number 

UCB$L_ORB - Object's rights block address 

UCB$L_LOCKID - Device lock ID 

UCB$L_CPID - PID charged for BUFQUO by UCBCREDEL 

UCB$L_CRB - Address of primary channel request block 

UCB$L_DDB - Pointer to device data block 

UCB$L_PID - Process ID of owner process 

UCB$L_LINK - Address of next UCB for respective DDB 

UCB$L_VCB - Address of volume control block 

UCB$B_DEVCLASS - Device class 

UCB$B_DEVTYPE - Device type 

UCB$W DEVBUFSIZ - Device default buffer size 
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UCB$S_NET_DEVDEPEND - Network fields 

UCB$B_LOCSRV - Local link services 
UCB$B_REMSRV - Remote link services 
UCB$W_BYTESTOGO - No. of bytes left in rev bfr 

UCB$W_RWAITCNT - Class Drivers — threads waiting 
resources 

UCB$B_CM1 - Level 1 controller allocation mask 
UCB$B CM2 - Level 2 controller allocation mask 
UCB$L_IRP - Current I/O request packet address 
UCB$W_REFC - Reference count of processes 
UCB$B_DIPL - Device interrupt priority level 

UCB$B_STATE - NET — link state for network transitions 

UCB$L_AMB - Associated unit control block pointer (Pointer 
to MAILBOX for NETWORK UCB) 

UCB$L_STS - Device unit status 

Timeout enabled 

Unit timed out 

Interrupt expected 

Cancel I/O on unit 

Set if this is template UCB 



UCB is busy 

Too many bytes revd 

Link has declared a connect name 

Link is being broken 

UCB$W_QLEN - Device queue length 

UCB$L_SVPN - System virtual page/map register number 

UCB$W_BCNT - Byte count of transfer 

UCB$L_PDT - ADDR of port descriptor table 
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1.1.2 Device-Dependent UCB Extensions 



Network Logical Link (Network Mailbox) Extension 

Connect is for logical link 

- ADDR of data subchannel status block 

- ADDR of interrupt subchannel status 
block 

DDCMP channel number 
Link type bits 
Segment request counts 
Message request counts 
Message ACK/NAK 
Backpressure 
Link priority (ignored) 

• NI Device Extension 



UCB$C 


LOGLNK - 


ucb$l" 


"NT DATSSB 


ucb$l~ 


1nt_intssb 


UCB$W 


NT CHAN - 


UCB$V" 


"LTYPE - 


UCB$V" 


"SEGFLO - 


UCB$V~ 


"MSGPLO - 


UCB$V" 


"MSGACK - 


UCB$V~ 


"backp - 


UCB$V" 


"lnkpri - 



UCB$C_NI_LENGTH - 
UCB$L_NI_HWAPTR - 

UCB$L NI MLTPTR - 



Size of NI Device UCB 

Address of NI device hardware 

address 

Address of protocol multicast table 
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1.2 Driver Prologue Table (DPT) 

• Describes driver size and device type to driver loader 

• Contains initial data for other data structures 

1.3 Device Data Block (DDB) 

• Describes device type, generic device name, controller 
designation and driver name 

• Points to first entry of UCB wv^ 

• *.< **+#^ 

1.4 Channel Request Block (CRB) ^^ ^ 

• Describes the characteristics and current state of a 
specific controller 

• Contains code to dispatch interrupts to the interrupt 
service routine 

• For NETDRIVER, there is no interrupt service routine 

1.5 Interrupt Data Block (IDB) v ° 

• Describes a specific controller 

• Points to the controller's CSR and associated ADP 

• For NETDRIVER, there is no CSR and associated ADP 



1.6 Adapter Control Block (ADP) 






• Describes the characteristics and current state of a 
specific adapter (i.e., MBA, UBA) 

• Not applicable to NETDRIVER 
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1.7 Channel Control Block (CCB) 

• Describes a device unit assigned to a software I/O channel 

wmmmmeummrm i m&m 



• Two CCBs of interest: 

- The one pointing to the Unit Control Block (UCB) of 
the mailbox driver (MBDRIVER). 

Unsolicited messages are handled by means of this CCB. 

- The one pointing to the UCB of the NETDRIVER. 

This one also points to the Extended window Block 
(XWB). The normal data is handled by means of this 
CCB. 



1.8 I/O Request Packets (IRP) 

• Constructed by the $QIO system service 

• Describes the I/O function to be performed 

• This is the key data structure that "flows" through the 
I/O subsystem, moving from one list to another 



if fer from normal ones in that the *$mmgmmM%5 
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1.8.1 Fields of the IRP 



IRP$L_PID - Process ID of requesting process 
IRP$L_AST/ASTPRM - Address/parameter of AST routine 
IRP$L_WIND - Address of window block 
IRP$L_UCB - Address of device UCB 
IRP$W_FUNC - I/O function code and modifiers 
IRP$B_EFN - Event flag number and event group 
IRP$B_PRI - Base priority of requesting process 
IRP$L_IOSB - Address of I/O status block 
IRP$W_CHAN - Process I/O channel number 
IRP$W_STS - Request status 
IRP$L_BCNT - Byte count of transfer 
IRP$S_NT_PRVMSK - Privilege mask for DECnet 
IRP$S_STATION - Station field for DECnet drivers 
IRP$L_ABCNT - Accumulated bytes transferred 
IRP$L OBCNT - Original transfer byte count 
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2 DECnet DATA STRUCTURES 
2.1 Routing Control Block (RCB) 

The Routing Control Block (RCB) is used as the network Volume 
Control Block. 

There is one RCB per system and it serves as the primary DECnet 
routing data structure. It is pointed to by the VCB fields of 
every UCB used by DECnet. 

The RCB contains pointers to the following data structures which 
help it maintain the routing database: 

• OA (Output Adjacency) 

• AOA (Area Output Adjacency Node Database Block) 

• ADJ (Adjacency) 

• LPD (Logical Path Descriptor) 

• LTB (Logical Link Table) 

• NDC (Node Counter Block) 
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RCB$Q_IRP_FREE 

RCB$W_SIZE 

RCB$B_TYPE 

RCB$B_STATUS 

RCB$W_TRANS 

RCB$W_ADDR 

RCB$L_AQB 

RCB$L_ACP_UCB 

RCB$L_PTR_JNX 

RCB$L_PTR_OA 

RCB$L_PTR_AOA 

RCB$L_PTR_LTB 

RCB$L_PTR_LPD 

RCB$L_PTR_ADJ 

RCB$L_PTR_TQE 

RCB$L_PTR_NDC 

RCB$L_PTR_DCS 

RCB$Q_LOC_RCV 

RCB$Q_LOC_XMT 

RCB$Q_IRP_WAIT 

RCB$W_MCOUNT 

RCB$W_CUR_LNK 

RCB$W_MAX_LNK 

RCB$W_MAX_ADDR 



I 



I 



i 
i 



1 



MKV87-0582 



Figure 4-2 Routing Control Block (RCB) 
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2.2 Output Adjacency (OA) 

• Maintained on routing nodes 

• Each entry is 2 bytes long 

• Number of entries corresponds to the maximum address 

• Each entry offsets to the adjacency node database block 
(ADJ) 

• Entry n corresponds to node address n 

• If a node is unreachable, the value is zero 

2.3 Area Output Adjacency (AOA) 

• Maintained on Level II (area) routing nodes 

• Used to determine the default adjacency to be used to get 
to a given area 

• Each entry is 2 bytes long 

• Number of entries corresponds to the maximum area 

• The index is the area address, the vector cell contains 
the ADJ index 

• A new AOA vector must be allocated whenever the maximum 
supported area address is increased 
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2.4 Adjacency Node Database Block (ADJ) 



• Used together with the logical path descriptor (LPD) to 
describe the next hop destination to any reachable node in 
the network 

• Stores information about the neighbor's node type, block 
size, listener interval (computed from neighbor's hello), 
etc. 

• The number of entries in this data structure can be much 
less than the maximum address 

The value is given by 

MAXIMUM CIRCUIT + 

MAXIMUM BROADCAST NONROUTERS + 

MAXIMUM BROADCAST ROUTERS + 1 

• Each entry is 13 bytes 



ADJ$B_STS 

ADJ$B_PTYPE 

ADJ$W_LPD 

ADJ$W_PNA 

ADJ$W_BUFS»Z 

ADJ$W_INT_LSN 

ADJ$W_TIM_LSN 

ADJ$B_BCPRI 



P 



ADJ$B_LPD_INX,ADJ$B_LPD_SEQ 



□ 
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Figure 4-3 Adjacency Node Database Block (ADJ) 
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2.5 Logical Path Descriptor (LPD) 

• Describes a path to a data link or a source 

• For incoming messages, the LPD points to the Enc 
Communication Layer (ECL) driver (NETDRIVER) of the local 
node 

• For outgoing messages, points to the UCB of the datalink 
driver (XMDRIVER) 

• Allows messages to be transmitted over the correct line 

• It also contains counters for packet sent or received or 
the circuit 

• The number of LPD entries depends on the number of 
circuits 

• Each LPD entry is 106 bytes 

• On routing changes, the information in the ADJ changes tc 
point to a new LPD 

2.5.1 Fields in the LPD 



• Number of data link start-up attempts since last "run" 

• UCB address 

• ACP channel to device 

• "TALKER" timer 

• "TALKER" interval (used to INIT TIMTLK) 

• Number of test messages left to send before entering 

• Number of outstanding IRPS queued by NETDRIVER 

• Local node type on this circuit 

• Output "square root limiter" value 

• Output queue "input packet limiter" 
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• Path ID, index and sequence 

• Status on control info 

• XMIT flags 

• X.25 PVC startup flags 

• Circuit substate 

• Circuit cost 

• Circuit NI router priority/designated router on NI 

• For broadcast circuits, LPDS, address of "most recently 
received election message" from router hello messages 

• ^r^dmport layer counters 

• Data-link buffer size including transport overhead 

• Address of end node cache storage (end nodes only) 
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2.5.2 Logical Link Table (LTB) 

• This structure is maintained by NSP (NETDRIVER) 

• Contains all local End Communications Layer parameters and 
a vector of logical link slots 

• The LTB has pointers back to the XWB for that logical link 

• The first entry after the 12 byte header is a link pointer 
that points to the first XWB used 

• Each slot in the vector is 4 bytes 

If the low bit is set, the slot is available and its 
sequence number (number of times used) is found in the 
high-order word. 

If the low bit is clear, the slot contains a pointer to 
the XWB with the link context and state information. 

• The size of this data structure is governed by the 
executor parameter maximum links 

(HEADER + MAX LINKS * 4) 
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LTB$L_SLT_NXT 

LTB$L_ASLT_NXT 

LTB$W_SLT_TOT 

LTB$W_SLT_LMT 

LTB$W_ASLT_LMT 

LTB$W_LSLT_TOT 

LTB$W_ASLT_LMT 

LTB$W_SIZE 

LTB$B_TYPE 

LTB$B_SPARE 

LTB$L_XWB 

LTB$L_PTR_ALIAS_SLOTS 

LTB$L_SLOTS 



MAX LINKS * 4 
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Figure 4-4 Logical Link Table (LTB) 
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2.6 Internal Connect Block (ICB) 

This data structure is used to pass generic connect informatior 
between the Network ACP and an End Communications Layer (BCD 
driver (for example, NETDRIVER) . ^«y«r ittLj 



ICB$W_PATH 

ICB$W_LOCLNK 

ICB$W_TIM_OCON 

ICB$W_TIM_INACT 

ICB$W_SIZE 

ICB$B_TYPE 

UNUSED 

ICB$W_RETRAN 

ICB$W_DLY_FACT 

ICB$W_DLY_WGHT 

ICB$W_SEGSIZ 

ICB$B_LPRNAM 

ICB$T LP R NAM 



ICB$B_RPRNAM 
ICB$T RPRNAM 



ICB$B ACCESS 



ICB$B_DSTFMT 
ICB$B DSTOBJ 



MKV87-OS87 



Figure 4-5 Internal Connect Block (ICB) 
(Sheet 1 of 2) 
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ICB$T ACCESS 



ICB$B_DATA 
ICB$T DATA 



ICB$W_REMNOD 
unused 

ICB$B_RID 
ICB$T RID 
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Figure 4-5 Internal Connect Block (ICB) 
(Sheet 2 of 2) 



4-21 



DECnet-VAX DATA STRUCTURES 



2.7 Logical Link Subchannel Block (LSB) 

This block is used to control the activity on a logical link 
subchannel. There are two subchannels: the DATA subchannel and 
the INTERRUPT/LINK subchannel. Every logical link has both 
subchannels. 

2.7.1 LSB Fields 

• Transmitter Control Variables 

Last segment number assigned to a segment 

Last segment number transmitted 

Highest segment number sendable 

Highest ACK number received 

Highest ACK number acceptable 

Flow control credits from remote receiver 

Packet window adjustment counter 

Size of the transmit-packet-window 

Number of active transmit CXBs 

Max total CXBs allowed 

Total CXBs both active on on the free queue 

Listhead for transmit IRPs containing data 

Listhead for transmit IRPs with data moved to CXBs 

Transmit CXB (message segments) listhead 

• Receiver Control Variables 

Receive IRP listhead 

Received CXB (message segments) listhead 

Highest numbered message received and accepted 

Highest ACK transmitted 

Number of CXBs in LSB list (unACKed) i 

Max rev CXBs that can be buffered by NSP before some 

are passed to the Session Layer 

• Miscellaneous 

Status bits 

Set for LS/INT subchannel 

Next segment to send has NSP$V_DATA_BOM set 

Next segment to send has NSP$V_DATA_EOM set 

Pointer to "cross-channel" LSB 

Length for use by XWB definition 
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2.8 Configuration Database Root Block (CNR) 

This block serves as the listhead for the CNFs of a particular 
component in the configuration database. It contains all of the 
component's semantics. 

2.9 Configuration Data Block (CNF) 

This is a general block structure used to carry a sub-block in the 
configuration database of NETACP. The CNF and sub-block semantics 
for each component type are stored in the associate CNR. 

2.10 Network Window Block (XWB) 

• The XWB describes activity on a logical link 

• Includes information such as flow control count, local and 
remote node logical link addresses 

• There is one XWB per logical link 

• This control block serves as the network window control 
block; as such its header section must look like a WCB 

• The remainder of the structure is network-specific 

• It contains the pointers to the data and interrupt 
subchannel block 

• This is the primary data structure describing logical 
links 
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2.11 Remote Node Information (NDI) 

This block has information that is commonly defined for all nodes 
known to the local node. 

It includes information that is used to downline load a node that 
is not up on the network yet. 

2.11.1 NDI Fields 

e Information for Active Nodes 

Node address - zero if NDI is for local node 

Counter timer (units = sec) 

Absolute due timer for counters to be logged 

Node Name 

Privileged user id 

Privileged account 

Privileged password 

NonPrivileged user id 

NonPrivileged account 

NonPrivileged password 

Receive password 

Transmit password 

Access switch (inbound, outbound, etc.) 

Proxy access switch (inbound, outbound, etc.) 

System node version 

Async Line - Inbound node type 

• Information for Inactive Nodes (To be downline loaded) 

Service device type 

CPU type 

Software type 

Host address (input and output) 

Service line 

Service password 

Load file 

Secondary loader 

Tertiary loader 

Software ID 

Dump address/Dump count 

Dump file/Secondary dumper 

Diagnostic load file 

NI hardware address for node 
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2.12 Local Node Information (LNI) 

The LNI defines information about the local node including its 
state and the setting of executor parameters. 

2.12.1 LNI Fields 

• Node address 

• Node State 

• Local node type 

• Maximum links allowed 

• Maximum node address 

• Maximum transport buffers 

• Maximum cost 

• Maximum hops 

• Maximum visits 

• Maximum circuits 

• Default LOOP data/count/length/help type 

• Transport forwarding buffer size 

• Transport segment buffer size 

• Routine suppression interval (units = sec) 

• Inactivity timer (units = sec) 

• Incoming timer (units = sec) 

• Outgoing timer (units = sec) 

• Routing timer (units = sec) 

• Broadcast routing timer (units = sec) 

• Maximum broadcast end nodes 

• Maximum broadcast routers 

• Delay factor 

• Delay weight 

• Retransmit factor 

• Default access (inbound, outbound, etc.) 

• Default proxy access (inbound, outbound, etc.) 

• Pipeline quota 

• X.25 subaddress range 

• Maximum areas 

• Area maximum hops 

• Area maximum cost 

• Alias local address (cluster node address) 

• Alias maximum links 

• Node name 

• Counters 

• System identification 

• NSP, Routing, and Network Management version 

• Physical NI address 
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2.13 Network Server Process Information (SPI) 

Network Server Process Information contains information that is 
used by a waiting network server process. 

2.13.1 SPI Information 

• Server PID 

• IRP of waiting DECLSERV QIO (0 if process active) 

• Remote node address which initially started server 

• Channel associated with DECLSERV IRP 

• Access Control used initially to start server process 

• Remote user ID which initially started server 

• Last (current) filespec given to server 

• Last (current) NCB given to server 

• Last (current) process name given to server 

• Structure size 
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2.14 Work Queue Elements (WQE) 

Work Queue Elements (WQE) are used by NETACP to serialize and 

standardize all schedulable but non-IRP oriented work. Datalink 

state transition control and events originating from ASTs are 
examples. 

The WQE structure is depicted in Figure 4-6. 



WQE$L_FLINK 

WQE$L_BLINK 

WQE$W_SIZE 

WQE$B_TYPE 

WQE$B_SUB 

WQE$L_ACTION 

WQE$L_PM1 

WQE$L_PM2 

WQE$L_EVL_PKT 

WQE$W_EVL_CODE 

WQE$B_EVL_DT1 

WQE$B_EVL_DT2 

WQE$W_ADJ_INX 

WQE$W SPARE 



WQE$B_EVT,WQE$B_QUAL 
WQE$W_REQIDT 



MKV87-0S91 



Figure 4-6 Work Queue Elements (WQE) 
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2.14.1 Queuing and Dequeuing WQES 

The WQE$B_SUB field is used to determine if any special processing 
is needed when the WQE is queued or dequeued as follows: 

• Spawned during normal internal ACP activity, e.g., durin< 
IO$_ACPCONTROL QIO activity (then no special action ii 
required when it is queued.) 

When it is dequeued, dispatch directly to the actioi 
routine that is responsible for deallocating it. 

• Consequence of a miscellaneous AST (a datalink QIO AST). 

When it is dequeued, dispatch directly to the actioi 
routine that is responsible for deallocating it. 

• Consequence of a mailbox read AST. 

When it is dequeued, it is sent to the mailbox servicing 
routine, which permanently owns the WQE. 

• Consequence of a timer AST. 

When it is dequeued, another VMS timer must be set il 
there are any more elements in the WQE timer queue. 

NOTE 

If any of the AST related elements is the 
first element queued, $ HAKE NETACP. 
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2.15 Node Counter Block (NDC) 

• Used to maintain statistics for each node in the network 

• A hash of these structures is contained in NETACP 

• The number of entries depends on maximum address 

• Each entry is 28 bytes 

• Contains information that can be displayed using the NCP 
show node xx counters command 

2.15.1 NOC Fields 

• Absolute time counter block was last zeroed 

• Transmitted connect rejects due to resource errors 

• Response timeouts 

• Connects received 

• Connects sent 

• Bytes received 

• Bytes sent 

• Packets received 

• Packets sent 



4-29 



DECnet-VAX DATA STRUCTURES 



2.16 Event Logger Data Structures 

There are two data structures used by EVL to do event logging, the 
Event Logging Filter information (EVI) block and the Event Logging 
Sink Information (ESI). 

2.17 Object Information Block (OBI) 

The Object Information Block (OBI) has information on network 
objects. 

2.17.1 OBI Fields 

• Object number 

• Proxy login switch (inbound, outbound, etc) 

• Channel over which declaration occurred 

• Low-order privilege mask 

• High-order privilege mask 

• Associated NET UCB if declared task 

• Associated process i.d. if declared task 

• Name 

• File id 

• User id 

• Account 

• Password 
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2.18 Circuit Information (CRI) 

The CRI contains information about each circuit, 
block for each circuit. 



There is one CRI 



2.18.1 CRI Fields 



Circuit name 

PID of temporary owner of line in service state 

Absolute due time for counter logging 

State 

Loopback name 

Hello timer 

Cost 

Maximum recalls 

Recall timer 

Call Number 

Type 

DTE 

Maximum block 

Maximum window 

Tributary 

Babble timer 

Transmit timer 

X.25 channel 

X.25 Usage 

Maximum receive buffers 

Maximum transmits 

Active base 

Active increment 

Inactive base 

Inactive increment 

Inactive threshold 

Dying base 

Dying increment 

Dying threshold 

Dead threshold 

Transport protocol 

Maximum routers on NI 

Router priority on NI 

Async line verification Enabled/Disabled 

X.25 network name 

Loopback name 
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2.19 Physical Line Information (PLI) 

The PLI includes information about the physical lines on the 
system. There is one PLI block for each line. 

2.19.1 PLI Fields 

• Line name 

e Absolute time to counter logging 

• Number of buffers in receive pool 

• State 

• Substate 
e Protocol 

• Counter timer 
e Service timer 

• Holdback timer 

• Retransmit timer 

• Maximum block 

• Maximum retransmits 
e Maximum window 

• Scheduling timer 

• Dead timer 
e Delay timer 

• Stream timer 

e NI hardware address [READ ONLY] 

e X.25 KMX microcode dump file [WRITE ONLY - ONE SHOT] 

e Ethernet protocol type 

• X.25 mode (DTE, DCE, etc.) 

• Transmit pipeline 

• Async Line - Line speed 
e Async Line - Switch 

• Async Line - Hangup 

• Buffer size to override executor buffer size 

• X.25 network name 
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USING THE SYSTEM DUMP ANALYZER (SDA) 



INTRODUCTION 

The System Dump Analyzer (SDA) utility is a useful tool to help 
analyze a crash dump or look at a running system. It allows you to 
format various data structures used by DECnet and to examine the 
contents of memory. 

Topics include: 

• Location of Data Structures 

• Using SDA to Look at DECnet Data Structures 
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1 LOCATION OF DATA STRUCTURES 

• Data Structures in Nonpaged Pool 

- Data link drivers 

- Data link buffers (CXB) 

- Circuit data (LPD) 

- Routing table (RCB) 

- Adjacency data (ADJ) 

- Logical link data (XWB) 

- Output adjacency (OA) 

- Area output adjacency (AOA) 

• Data Structures in Paged Memory (from Volatile Database) 

- Local node database (LNI) 

- Remote node database (NDI) 
Line database (PLI) 

- Circuit database (CRI) 

- Object database (OBI) 

- Event database (EFI,ESI) 
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2 DATA STRUCTURE TRACE USING SDA 

The following system crash dump was taken on VMS version 4.4. 

The purpose is not to analyze the cause of the crash but rather to 
trace the key DECnet data structures discussed. 

The NCP and DCL commands show the executive, circuit, and system 
characteristics prior to the crash. 

The SDA trace looks at key DECnet data structures relating to the 
network data link drivers, network pseudo devices (NETn), the 
routing database (RCB,ADJ,OA) , logical link structures (LTB), and 
the node counter block. 

Numbered comments explaining the analysis of the data appear after 
the trace in Section 2.11. 
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2.1 Looking at the System Before the Crash 

% SHOW NETWORK 

VAX/VMS Network status for local node 1.2 THUD on 23-MAV-1986 13:57:06.13 






Node 



Links Cost Hops Next Hop to Node 



1.2 

1. 1 
1.4 
1.5 
1.6 



THUD 

SPLASH 

BAROOM 

CLICK 

DRIP 




4 

1 





(Local) 

UNA-0 

UNA-0 

UNA-0 

UNA-0 



-> 

-> 
-> 

-> 
-> 



1.2 
1. 1 
1.4 
1.5 
1.6 



THUD 

SPLASH 

BAROOM 

CLICK 

DRIP 






Total of 5 nodes. 



$ SHOW SYSTEM 

VAX/ VMS V4.4 on node 
Pid Process Name 

00000080 NULL 

00000081 SWAPPER 

00000084 ERRFMT 

00000085 OPCOM 

00000086 J0BC0NTR0L 
00000089 NETACP 
00000O8A EVL 
0000008B REMACP 

_1031 
'NETM032 




00000097 SYSTEM 



SHOW USERS 

VAX/VMS Interactive Users 
Total number of Interactive users 
Username Process Name PID 
SCOTT Scott 00000092 

SYSTEM SYSTEM 00000096 



THUD 


23-MAY- 


•1986 


13:55:51.27 


Upt 


Ime 01 


3:42 


State Pr1 


I/O 




CPU 




Page fits 


Ph.l 


COM 











00:33:15, 


,03 








HIB 


16 








00:00:00. 


79 








HIB 


8 


41 





00:00:00. 


,72 


70 


89 


LEF 


a 


48 





00:00:01, 


,25 


247 


121 


HIB 


8 


62 





00:00:00. 


.74 


83 


204 


HIB 


9 


144 





00:00:07. 


.19 


315 


231 


HIB 


5 


53 





00:00:01. 


.71 


816 


32 


HIB 


9 


23 





00 : 00 : 00 


,31 


74 


40 


LEF 


6 


196 





00:00:07 


.55 


748 


211 


LEF 


6 


103 





00:00:04 


.42 


425 


263 


LEF 


6 


124 





00:00:05 


.06 


887 


150 


HIB 


7 


250 





00:00:17 


.38 


1163 


249 


CUR 


4 


183 





00:00:04 


.64 


762 


196 



>.«f 









X3* .o> ylff 



^ 



^°^*\ 

w 



N 
N 

N 



H^*'* 






^ *£** 



^ 



23-MAY-1986 13:56:19.70 



= 2 



Terminal 

OPAO: 

RTA1: 
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S MCR NCP 

NCP> SHOW EXECUTOR CHARACTERISTICS 

Node Volatile Characteristics as of 23-MAV-1986 13:52:40 

^. Executor node - 1.2 (THUD) 

H?Jik Identification « VAX 750 - Standalone System 

■i-v^Z? , Management version ■ V4.0.0 
3 gov » Incoming timer 
?-t7m?J Outgoing timer 

J 8*? NSP version « V4.0.0 VV A' 

>C^ Maximum links =32 ~* > 

Delay factor = 80 0<, .-S-^ 

Delay weight > 5 o^^ ff 1 

Inactivity timer ■ 60 ^ ^ »*" 

Retransmit factor =10 # ^5 ^ 

Routing version = V2.0.0 ^ v ^"Js 



qT 





Type = routing IV $< (P tf' 

Routing timer = 600 «, %»<* ssP 

Broadcast routing timer = 160, (Cf- or £• 

Maximum address = ( <5J 5 ="? ^ 

Max 1 mum c 1 rcu 1 1 s 

Maximum cost 

Maximum hops 

Maximum visits 

Maximum area 

Max broadcast nonrouters = 64 

Max broadcast routers = 32 

Area maximum cost - 1022 

Area maximum hops = 30 

Maximum buffers ■ 15 

Buffer size = 576 

NonpMvl leged user Id = DECNET 

Default access = Incoming and outgoing 

Pipeline quota = 5000 

Default proxy access = Incoming and outgoing 

Parameter #2743 = 32 






.V 



^$9?\* 



> 



if 







5-8 



USING THE SYSTEM DUMP ANALYZER (SDA) 



NCP>SHOW KNOWN NODES SUMMARY 



Executor node = 1.2 (THUD) 



State 

I dent if! cat Ion 



= VAX 750 - Standalone System 



Node 


State 


Active 
Links 


Del 


lay 


Circuit 


Next node 




1.1 (SPLASH) 


reachable 


4 




1 


UNA-0 


1.1 (SPLASH) 




1.3 (ZIP) 


unreachable 












1.4 (BAROOM) 


reachable 


1 




1 


UNA-0 


1.4 (BAROOM) 


l.S (CLICK) 


reachabl e 








UNA-0 


1.5 (CLICK) 


1.6 (DRIP) 


reachabl e 








UNA-0 


1.6 (DRIP) 


1.13 (FIZZ) 


unreachable 












1.14 (SNAP) 


unreachable 












1.15 (POOF) 


unreachable 
















NCP> SHOW ACTIVE CIRCUITS CHARACTERISTICS 
Circuit = DMC-0 



State 


= 


on 


Substate 


= 




Service 


= 


enabled 


Cost 


= 


2 


He 1 1 o 1 1 me r 


= 


15 


Verification 


= 


disabled 


Circuit = UNA-0 






State 


= 


on 


Service 


= 


enabled 


Designated router 


= 


1.6 (DRIP) 


Cost 


= 


1 


Router priority 


= 


64 


Hel lo timer 


= 


15 


Type 


= 


Ethernet 


Adjacent node 


= 


1.6 (DRIP) 


Listen timer 


= 


45 
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NCP>SH0W KNOWN LINKS STATUS 









w 



Known Link Vol at 11* Summary aa of 23-MAV-1986 13:56:30 



Link 




Nods 


PIO Procaaa Ramota 


link 


Ramota 


uaar Stata 


1031 


1. 


, 1 (SPLASH) 


0000008F 


FAL 1031 


B223 


SCOTT 


run 


1032 


1. 


1 (SPLASH) 


00000090 


NET"l032 


7200 


SCOTT 


01 received 


1036 


1. 


, 1 (SPLASH) 


00000092 


Scott 


8225 


FAL 


run 


1046 


1. 


1 (SPLASH) 


0000008B 


REMACP 


8232 


SCOTT 


run 


1034 


1. 


4 (BAROOM) 


00000091 


NET 1034 


1028 


DRV2 


run 



,v 



V 






* n 



NCP>TELL SPLASH SHOW KNOWN LINKS 

Known Link Volatile Summary as of 23-MAV-1986 13:58:00 

Link Node PIO Process Remote link Remote user State 



8223 


1. 


,2 


(THUD) 


2060126F 


Scott #3 


1031 


FAL 


run 


8225 


1. 


.2 


(THUD) 


2060177C 


FAL 8225 


1036 


SCOTT 


run 


8232 


1. 


,2 


(THUD) 


2060126F 


Scott #3 


1045 


CTERM 


run 


8231 


1, 


,2 


(THUD) 


2060137E 


NML 8231 


1042 


SVSTEM 


run 



NCP>TELL BAROOM SHOW KNOWN LINKS 



Known Link Volatile Summary as of 23-MAV-1986 13:58:36 

Link Node PID Process Remote link Remote user State 



1028 1.2 (THUD) 
2055 1.2 (THUD) 



20A0009B DRV2 
20A0009F NML 2055 



1034 TARGET1.EXE 
1044 SVSTEM 



run 
run 
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2.2 Getting Started with SDA 



SOA> READ SYS$SYSTEM:SYSDEF 
SDA> READ SYSSSYSTEMiNETDEF 



!VMS data structure definitions 
IDECnet data structure definitions 



V 



V 



SDA> SHOW SUMMARV 
Current process summary 



Extended 


Indx 


Process name 


User name 


State 


Prl 


PCB 


PHD 


Wkset 


00000080 


0000 


NULL 




COM 





800024AB 


80002328 





00000081 


0001 


SWAPPER 




HIB 


16 


80002748 


800025C8 





00000084 


0004 


ERRFMT 


SYSTEM 


HIB 


8 


801545D0 


802EA200 


89 


00000085 


0005 


OPCOM 


SYSTEM 


LEF 


8 


80155490 


8031BE00 


121 


00000086 


0006 


JOB CONTROL 


SYSTEM 


HIB 


10 


801557A0 


80334C00 


204 


00000089 


0009 


NETACP 


DECNET 


HIB 


10 


80162B70 


B034DA00 


236 


0000008A 


000A 


EVL 


OECNET 


HIB 


6 


80163D50 


80366800 


43 


0000008B 


000B 


REMACP 


SYSTEM 


HIB 


9 


80 168 ICO 


8037F600 


40 


. 0000008F 


OOOF 


FAL 1031 


SCOTT 


LEF 


6 


80165190 


80398400 


211 


V 00000090 


0010 


NET~1032 


SCOTT 


LEF 


6 


80169AD0 


803B1200 


263 


00000091 


0011 


NET~1034 


NET1 


LEF 


6 


80169070 


803CA000 


150 


00000092 


0012 


Scott 


SCOTT 


CUR 


6 


80155370 


80303000 


198 


00000097 


0017 


SYSTEM 


SYSTEM 


LEF 


4 


80169970 


803E2E00 


148 



iX^ 



c> 



^ 



X 






^ 



>F 






x 



V 



or" * 



<S 



^ 
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2.2.1 SDA> SHOW CRASH 

System crash Information 

Time of system crasht 23-MAV-1986 14:02:32.21 

Version of system: VAX/VMS VERSION V4.4 

VAXc luster node name: THUD 

Reason for BUGCHECK exception: OPERATOR, Operator requested system shutdown 

Process currently executing: Scott 

Current Image file: THUDSDRAO: I SYSO. ) [SVSEXE10PCCRASH.EXE; 1 

Current IPL: 31 (decimal) 

General registers: 



RO = OOOOOOOB 
R4 = 801S5370 
R8 = 7FFE0052 
AP = 00000000 
PSL - 00DF0000 

Processor registers: 



Rl 


= 


00000241 


R2 » 


7FF0B390 


R5 


s 


00000001 


R6 = 


7FFED78A 


R9 


= 


7FFED2SA 


RIO = 


00000000 


FP 


= 


7FFE7DD0 


SP * 


7FFE7DO0 



R3 = 80000FF8 
R7 = 7FFED7BA 
Rll = 7FFE33DC 
PC = 0000036E 



POBR 


= 


80307EOO 


PCBB = 


00501478 


ACCS = 


00000001 


POLR 


s 


00000004 


SCBB = 


007EA200 


TBOR - 


00000000 


P1BR 


= 


7FB1BE00 


ASTLVL - 


00000004 


CAOR = 


00000000 


P1LR 


= 


001FF9DA 


SISR = 


00000000 


MCESR = 


00000004 


SBR 


■ 


007EE600 


ICCS = 


800000C1 


CAER a 


00000000 


SLR 




00004680 


ICR - 
TOOR = 


FFFFEA94 
S960D6FC 


CMIERR ■ 


00080310 


ISP 


s 


802E9C00 










KSP 


= 


7FFE7000 










ESP 


= 


7FFE9E0O 










SSP 


a 


7FFE004E 










USP 


= 


7FF3DB94 
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2.2.2 SDA> SHOW POOL/SUMMARY . K^T 



IRP lookaside list 

Summary of IRP lookaside 11st 



• \ 



Aw 



0- 



3 


CRB 


90 


FCB 


20 


IRP 


1 


WCB 


2 


NET 


11 


JIB 


6 


RSB 


1 


INIT 



624 (2%) 

= 18720 (67*) 

■ 4160 (14*) 

= 208 (0*) 

= 416 (1*) 

= 2288 (8«) 

= 1248 (4*) 

- 208 (0*) 

Total space used = 27872 out of 108160 total bytes, B0288 bytes left 
Total space utilization = 25* 

LRP lookaside list 

Summary of LRP lookaside 11st 

8 CXB = 12672 (80*) 
1 DPT = 1584 (10*) 
1 LKIO - 1584 (10*) 

Total space used = 15840 out of 33264 total bytes, 17424 bytes left 
Total space utilization = 47* 

SRP lookaside list 



Summary of SRP 


lookaside list 


3 


AOP 


s 


288 


(1*) 


2 


AQB 


= 


192 


(1*) 


10 


CRB 


= 


960 


(6*) 


11 


DOB 


= 


1056 


(6*) 


13 


IDB 


= 


1248 


(8*) 


11 


TQE 


= 


1056 


(6*) 


89 


WCB 


= 


8544 


(55*) 


8 


BUFIO 


= 


768 


(4*) 


2 


NET 


= 


192 


(1*) 


1 


PTR 


■ 


96 


(0*) 


7 


LKB 


= 


672 


(4*) 


1 


RSB 


= 


96 


(0*) 


1 


RIGHTSLIS = 


96 


(0*) 


1 


CIA 


= 


96 


(0*) 


1 


INIT 


s 


96 


(0*) 



Total space used = 15456 out of 71616 total bytes, 56160 bytes left 
Total space utilization = 21* 
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Nonpaged dynamic storage poo) 



Summary of nonpaged 


pool content* 


40 


UNKNOWN 


a 


16816 


(11%) 


1 


ADP 


a 


608 


(0%) 


10 


PCB 


a 


2880 


(1%) 


2 


RVT 


8 


34304 


(23*) 


26 


UCB 


a 


10544 


(7%) 


4 


VCB 


s 


960 


(OK) 


1 


WCB 


a 


21808 


(14%) 


4 


NET 


a 


2624 


(1%) 


5 


DPT 


a 


31744 


(21%) 


2 


RBM 


a 


992 


(0%) 


3 


VCA 


a 


4B96 


(3%) 


1 


RSHT 


= 


1040 


(OX) 


5 


INIT 


a 


18912 


(12%) 



Total space used = 148128 out of 287744 total bytes, 139616 bytes left 
Total space utilization = 51% 

Paged dynamic storage pool 



Summary of paged 


pool 


contents 


10 


UNKNOWN 


s 


69392 


(34%) 


1 


PQB 


= 


2256 


(1%) 


85 


GSD 


= 


4096 


(2%) 


71 


KFE 


= 


4560 


(2%) 


3 


MTL 


= 


96 


(0%) 


1 


JNLWCB 


a 


22864 


(11%) 


56 


KFRH 


a 


17776 


(8K) 


1 


TWP 


a 


12336 


(6%) 


1 


RSHT 


= 


528 


(0%) 


208 


LNM 


a 


15392 


(7%) 


1 


FLK 


= 


11624 


(5*) 


1 


RIGHTSLIS 


= 


2560 


(1%) 


2 


KFO 


s 


96 


(0%) 


1 


KFPB 


s 


16 


(0%) 


2 


CIA 


= 


19456 


(9%) 


1 


PFB 


a 


16720 


(8%) 


1 


ORB 


= 


2048 


(1%) 



Total space used = 202016 out of 253952 total bytes, 51936 bytes left 
Total space utilization a 79% 
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lB* 



YD* 



qY^ 



2.3 Using SDA to Look at Data Link Drivers 



2.3.1 SDA> SHOW DEVICE XEA 



^jU^^ii^ ^ 



, o^ v 



^ 



DDB list 
Address Controller ACP Driver 
802B15E0 XEA XEORIVER 

Controller: XEA 

Device Data Block (DDB) 802B15E0 

Driver name XEDRIVER 



Al loc . class 
SB address 
UCB address 



DPT DPT size 
80156F80 3930 



DDT address 
BO0O0EF4 
8015A8B0 



80157050 



— Primary Channel Request Block (CRB) 802B15S0 



Reference count 4 Walt queue empty 

IDB address 802B1700 Datapath 

AOP address 8O14FA00 Unit 1n1t. 801572FC 
Unit start rout .801573A2 



Aux . struct. 
Map reg. 
Int. service 
Ctrl. 1n1t. 



Interrupt Data Block (IDB) 802B1700 

CSR address 8002F548 Owner UCB addr. 00000000 ADP address 
Number of units 8 Interrupt vector 000120 

Driver Dispatch Table (DDT) 80157050 



Err log buf sz 
Start I/O 
Alt start I/O 
Cancel I/O 



Dlag buf sz 76 FDT size 

80158148 Register dump 801597D3 FDT address 

801578BA Unit Inlt return Mnt verify 

80159E92 Unsol Int return Cloned UCB 



8015AAA0 

48(6) 

80158AB3 

801572F8 



8O14FAO0 



76 
80157088 
8000CF43 
801572F9 



XEAO 



X^*^ 



DEUNA 



UCB address: 8015A8B0 



^.. 



Device status: 00002010 on 1 1ne, template 
Characteristics: 0C0420O0 net ,avl , Idv.odv 

00000000 
Owner UIC I 000000, 000000) Operation count 

PIO 00000000 Error count 
Class/Type 20/0E Reference count 

Def. buf. size 512 BOFF 
OEVOEPEND 00000000 Byte count 
DEVDEPND2 00000000 SVAPTE 
FIPL/DIPL 08/15 DEVSTS 

Charge PID 00000000 

*•* I/O request queue Is empty ♦** 






0R8 address 
DDB address 
DDT address 
0000 CRB address 
0000 I/O wait queue 
00000000 
0000 






8015AA3B 
802B15E0 
80157050 
802B1580 
empty 



<t^> ^ 



> 



^ c 
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USING THE SYSTEM DUMP ANALYZER (SDA) 



XEAl 

Device stat 
Character-Is 

Owner UIC [ 

PID 
Class/Type 
Oef. buf. s 
DEVDEPEND 
OEVDEPND2 
FIPL/DIPC 
Charge PID 
*** I/O 



usi OO01O010 

tics: 0C042000 

00000000 

000001,000004] 

00010009 

20/OE 

1«e 1498 

OOOOOBOO 

00000000 

0B/15 

00010009 

request queue 



OEUNA 

on) 1ne , deleteucb 
net.avl , Idv.odv 










UCB address: 80164320 



Operation count 


2410 


ORB 


address 


801644AB 


Error count 





DOB 


address 


802B15E0 


Reference count 


2 


DOT 


address 


80157050 


BOFF 


0098 


CRB 


address 


802B1580 


Byte count 


0047 


AMB 


address 


80162C90 


SVAPTE 


B0BAE46C 


I/O 


wait queue empty 


DEVSTS 


0075 








1s empty »*• 











XEA2 



OEUNA 




Device status: 00010010 on 1 Ine, deleteucb 
Characteristics: 0C052000 net .shr.avl , idv.odv 

00000000 
Owner UIC [000000,000000] Operation count 



UCB address: 80164720 



PID 
Class/Type 
Def. buf. size 
DEVDEPEND 
DEVDEPND2 
FIPL/DIPL 
Charge PID 



00000000 Error count 

20/OE Reference count 
1498 BOFF 

00000800 Byte count 

00000000 SVAPTE 
08/15 DEVSTS 

00010009 



1 



2 

004E 

0042 

802AF840 

0010 



ORB 
ODB 
DDT 
CRB 
I/O 



*** I/O request queue Is empty **• 



address 
address 
address 
address 
wait queue 



801648AB 
802B15E0 
80157050 
80281580 
empty 






XEA3 



DEUNA 



UCB address: 80164910 



Device status: 


00010010 online, deleteucb 








Characteristics: 


0C052000 net .shr.avl ,1dv, 
00000000 


odv 








Owner UIC [OOO00O.0O00O0] Operation count 




1 


ORB 


address 60164A9B 


PID 


00000000 Error count 







ODB 


address 802B15E0 


Class/Type 


20/OE Reference count 




2 


DDT 


address 80157050 


Def. buf. size 


1500 BOFF 




004E 


CRB 


address 802B1580 


DEVDEPEND 


00000800 Byte count 




0042 


I/O 


wait queue empty 


DEVDEPND2 


00000000 SVAPTE 


802AF780 






FIPL/OIPL 


08/15 DEVSTS 




0010 






Charge PID 


00010009 











*.** I/O request queue 1s empty *** 
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USING THE SYSTEM DUMP ANALYZER ( SDA) 



2.3.2 SDA> SHOW DEVICE XMA 



^ 



3JV 



W 



Address 



ODB list 
Control ler 



ACP 



Driver 



DPT 



DPT size 



802B1C40 XMA 
Controller: XMA 



XMORIVER 



8015ADB0 1000 



Device Data Block (DDB) 802B1C40 

Driver name XMDRIVER Alloc, class DDT address 8015ADEC 

SB address 80000EF4 
UCB address 8015BDB0 

Primary Channel Request Block (CRB) 80241AC0 



Reference count 1 Walt queue empty 
IDB address 802B1BE0 Datapath 

AOP address 8O14FA0O Unit Inlt. 8015AE90 

Interrupt Data Block (IDB) 802B1BE0 



Map reg. 78(2) 
Int. service 8015B8A8 



CSR address 8002DC38 
Number of units 8 



Owner UCB addr. 00000000 ADP address 8014FAOO 
Interrupt vector 000300 



Driver Dispatch Table (DDT) 8015ADEC 



Err log buf sz 
Start I/O 
Alt start I/O 
Cancel I/O 



Dlag buf sz 68 FDT size 64 

8015B2S5 Register dump 8015BACE FDT address 8015AE24 

8015AFF4 Unit 1n1t return Mnt verify B000CF43 

8015BB9E Unsol Int return Cloned UCB return 



XMAO 



DMR11 



UCB address: 



8015BD80 



Device status: 


00000010 


onl 1ne 




Character 1 s t 1 cs : 


0C042000 
00000000 


net ,avl , 1dv , odv 




Owner UIC [000000.0000001 


Operation count 


338 


PID 


00010009 


Error count 





Class/Type 


20/02 


Reference count 


2 


Def . buf. size 


576 


BOFF 


01C8 


DEVOEPEND 


86000800 


Byte count 


0006 


DEVDEPND2 


00000000 


SVAPTE B08AE460 


FIPL/DIPL 


08/15 


DEVSTS 


0008 


Charge PID 


00000000 






*** I/O request queue 


Is empty *** 





ORB address 8015BF9E 
DDB address 802B1C40 
DDT address B015ADEC 
CRB address 80241AC0 
AMB address B0162C90 
I/O wait queue empty 
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USING THE SYSTEM DUMP ANALYZER (SDA) 

2.4 Using SDA to Look at Network (NETxx) Devices 

2.4.1 SDA> SHOW DEVICE NET 

I/O data structures 

DOB list 



Address Controller ACP Driver DPT DPT size 
B02A7BC0 NET NETDRIVER 8015ES20 3B00 

Controller: NET 



Device Data Block (DDB) 802A7BC0 

Driver name NETDRIVER Alloc, class DDT address 8015E5B0 

SB address 80000EF4 
UCB address 80162020 

Primary Channel Request Block (CRB) 802A7920 

Reference count 11 Walt queue empty 

IDB address 802A72C0 Unit init. 8015E892 Int. service 8015E891 

Unit start rout .8015EF19 Ctrl. init. 8015E891 

Interrupt Data Block (IDB) 802A72C0 

CSR address 00000000 Owner UCB addr. 00000000 AOP address 00000000 
Number of units 8 



Driver Dispatch Table (DOT) 8015E5B0 

Errlog buf sz D1ag buf sz FDT size 88 

Start 1/0 8015EA40 Register dump return FDT address 8015E5E8 

Alt start I/O 8015F493 Unit Init return Mnt verify 8000CF43 

Cancel I/O 8015EE2B Unsol Int 8015F5F0 Cloned UCB return 
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USING THE SYSTEM DUMP ANALYZER (SDA) 



^r 






d^ 



t< 



NETO 



Unknown 



UCB address: 80162020 



Device status: 00002010 onllnt, tempi ate 
Characteristics: 0C1C2000 nat ,avl ,mnt ,mbx , Idv.odv 
00000000 

Ownar UIC [000001,000001] Operation count 

PIO 00000000 Error count 
Class/Type 00/00 Reference count 
Oaf. buf. size 256 BOFF 
OEVDEPENO 00000001 Byte count 



OEVDEPND2 
FIPL/DIPL 
Charge PIO 



00000000 SVAPTE 
08/08 DEVSTS 
00000000 






ORB 


address 


801620BO 





DOB 


address 


802A7BC0 





DOT 


address 


B015E5B0 


0000 


VCB 


address 


80162E90 


0000 


CRB 


address 


802A7920 


00000000 


I/O 


wait queue empty 


0000 









*** I/O request queue Is empty •** 

Volume Control Block (VCB) 80162E90 

Transactions 6 Mount count 11992 AQB address 

ACP Queue Block (AQB) 80162E70 

ACP requests are serviced by process NETACP whose PID Is 00010009 



80162E70 



Status: 01 unique 
Mount count 1 



ACP type 
ACP class 



net 
128 



Linkage 
Request queue 



B02A3E40 
empty 



*** ACP request queue Is empty »*• 



NET1 



Unknown 



UCB address: 80162080 



Device status: 


00010010 


onl Ine.deleteucb 










Characteristics: 


0C1C2000 
00000000 


net ,av1 ,mnt ,mbx , Idv 


,odv 








Owner UIC [000001,000004] 


Operation count 





ORB 


address 


80162E10 


PID 


00010009 


Error count 





OOB 


address 


802A7BC0 


Class/Type 


00/00 


Reference count 


1 


DOT 


address 


8015E5B0 


Def. buf. size 


256 


BOFF 


0000 


VCB 


address 


80162E90 


OEVDEPENO 


00000001 


Byte count 


0000 


CRB 


address 


802A7920 


DEVDEPND2 


00000000 


SVAPTE 00000000 


AM8 


address 


80162C90 


FIPL/DIPL 


08/08 


DEVSTS 


0002 


I/O 


wait queue emoty 


Charge PID 


00010009 













*** I/O request queue Is empty *** 
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USING THE SYSTEM DUMP ANALYZER ( SDA) 



Volume Control Block (VCB) B0162E90 

Transactions 6 Mount count 11992 AQB address 

ACP Queue Block (AQB) 80162E70 

ACP requests are serviced by process NETACP whose PID 1s 00010009 
Status: 01 unique 



80162E70 



ACP type 
ACP class 



Mount count 1 

ACP class 

*** ACP request queue is empty *** 



net Linkage 802A3E40 
12B Request queue empty 



NET3 



Unknown 



Device status: 00010010 onl Ine.del eteucb 
Characteristics: 0C1C2000 net ,avl .mnt ,mbx , Idv.odv 
00000000 



Owner UIC 


[00000 


1.000004] 


Operation count 7 


PID 




0001000A 


Error count 


Class/Type 




00/00 


Reference count 1 


Def. buf. 


size 


256 


BOFF 0000 


DEVDEPEND 




00000001 


Byte count 0000 


DEVDEPND2 




00000000 


SVAPTE 00000000 


FIPL/DIPL 




08/08 


DEVSTS 0002 


Charge PID 




0001000A 





UCB address: 80163C60 



ORB address 80163CF0 
DDB address 802A7BC0 
DOT address 8015E5B0 
VCB address 80162E90 
CRB address 802A7920 
I/O wait queue empty 



*** I/O request queue is empty *** 

Volume Control Block (VCB) 80162E90 

Transactions 6 Mount count 11992 AQB address 

ACP Queue Block (AQB) 80162E70 

ACP requests are serviced by process ufcTACP whose PID is 00010009 
Status: 01 unique 
Mount count 1 



80162E70 



ACP type 
ACP class 



*** ACP request queue is empty *** 



net Linkage 

128 Request queue 



802A3E40 
empty 
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USING THE SYSTEM DUMP ANALYZER (SDA) 



NET4 

Device atat 
Character Is 

Owner UIC [ 

PID 
Class/Type 
Oaf. buf. s 
DEVDEPEND 
DEVDEPND2 
FIPL/DIPL 
Charge PID 
**• I/O 



uai OOO1OO10 

tlca: 0C1C2000 

00000000 

000001,000004] 

0001000A 

00/00 

Ize 256 

FFFFFFFF 

00000000 

08/08 

0001000A 

request queue 



Unknown 

on 1 ine.deleteucb 

net , avl ,mnt ,mOx , Idv.odv 



Operation count 

Error count 

Reference count 

BOFF 

Byte count 

SVAPTE 

DEVSTS 

Is empty *** 



UCB address: 



80163F60 



it 2 


ORB 


address 


80163FF0 





ODB 


address 


S02A7BC0 


it 1 


DOT 


address 


8015E5B0 


0000 


VCB 


address 


80162E90 


0000 


CRB 


address 


802A7920 


00000000 


AMB 


address 


80163E70 


0002 


I/O 


wait queue empty 



Volume Control Block (VCB) 80162E90 

Transactions 6 Mount count 11992 



AQB address 



80162E70 



ACP Queue Block (AQB) 80162E70 

ACP requests are serviced by process NETACP whose PID Is 00010009 



Status: 01 unique 
Mount count 1 ACP type 

ACP class 
*** ACP request queue 1s empty *** 



net 
128 



Linkage 
Request queue 



802A3E40 
empty 



NET30 



Unknown 



Device status: 00010010 online, deleteucb 
Characteristics: 0C1C2000 net , avl ,mnt ,mbx , idv.odv 

00000000 
Owner UIC [000100,000025] 
PID 0001000F 
Class/Type 00/00 

Def. buf. size 256 
DEVDEPEND 00000001 
DEV0EPND2 00000000 
FIPL/DIPL 08/08 

Charge PID 0001000F 

*** I/O request queue is empty *** 

Volume Control Block (VCB) 80162E90 

Transactions 6 Mount count 11992 



Operation count 


7 


Error count 





Reference count 


1 


BOFF 


0058 


Byte count 


0005 


SVAPTE 802AAEC0 


DEVSTS 


0002 



UCB address: 801654E0 



ORB address 80165570 

DDB address 802A7BC0 

DDT address 8015E5B0 

VCB address 80162E90 

CRB address 802A7920 

AMB address 80165010 
I/O wait queue empty 



AQB address 



80162E70 



ACP Queue Block (AQB) 80162E70 

ACP requests are serviced by process NETACP whose PID Is 00010009 



Status: 01 unique 
Mount count 1 ACP type 

ACP class 
*** ACP request queue is empty *** 



net 
128 



Linkage 
Request queue 



802A3E40 
empty 
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USING THE SYSTEM DUMP ANALYZER ( SDA) 



NET40 



Unknown 



UCB address: B01656C0 



Opera t Ion 


count 


7 


Error count 







Reference 


count 


1 


BOFF 






004A 


Byte count 




0005 


SVAPTE 




802B07AO 


DEVSTS 






0002 



ORB address 80165750 

ODB address B02A7BC0 

DDT address 

VCB address 

CRB address 802A7920 

I/O wait queue empty 



8O15E5B0 
80162E90 



Device status: 00010010 online .deleteucb 
Characteristics: 0C1C2000 net , av 1 ,mnt ,mbx , idv , odv 

00000000 
Owner UIC [000100,000025] 
PID 00010012 
Class/Type 00/00 

Def. buf. size 256 
DEVDEPEND 00000001 
DEV0EPN02 00000000 
FIPL/DIPL 08/08 

Charge PID 00010012 

*** I/O request queue is empty *** 

Volume Control Block (VCB) B0162E90 

Transactions 6 Mount count 11992 AQB address 80162E70 
ACP Queue Block (AQB) 80162E70 

ACP requests are serviced by process NETACP whose PID is 00010009 

Status: 01 unique 



Mount count 1 ACP type net 

ACP class 126 

«*» ACP request queue is empty *** 



NET57 



Unknown 



Linkage 
Request queue 



UCB address: 



802A3E40 
empty 

8016B530 



Device status: 00010010 on! ine .deleteucb 
Characteristics: 0C1C2000 net ,avl ,mnt ,mbx , idv ,odv 

00000000 
Owner UIC [000001,000003] 
PID 0001000B 
Class/Type 00/00 

Def. buf. size 256 
DEVDEPEND 00000001 

0EVDEPN02 00000000 
FIPL/DIPL 08/08 

Charge PID 0001000B 

*** I/O request queue is empty *** 

Volume Control Block (VCB) 80162E90 — 

Transactions 6 Mount count 11992 



Operation count 


113 


Error count 





Reference count 


1 


BOFF 


006B 


Byte count 


0005 


SVAPTE 8024B520 


DEVSTS 


0002 



ORB address 801685C0 

DDB address 802A7BC0 

DDT address 8015E5B0 

VCB address 80162E90 

CRB address 802A7920 

AMB address 80164F20 
I/O wait queue empty 



AQB address 



80162E70 



ACP Queue Block (AQB) 80162E70 

ACP requests are serviced by process NETACP whose PID is 00010009 



Status: 01 unique 
Mount count 1 ACP type 

ACP class 
*** ACP request queue is empty *** 



net Linkage 802A3E40 

128 Request queue empty 
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USING THE SYSTEM DUMP ANALYZER (SDA) 

2.5 Using SDA to Look at Mailbox (MBAN) Devices 

2.5.1 SDA> SHOW DEVICE MB 

I/O data structures 

DDB list 



Address Controller ACP Driver DPT DPT size 
800013BC MBA MBDRIVER 8000185C 0602 

Controller: MBA 



Device Data Block (DOB) 800013BC 

Driver name MBDRIVER Alloc, class DDT address 800019AC 

SB address 80000EF4 
UCB address 800014E8 

Primary Channel Request Block (CRB) 80001814 

Reference count 6 Wait queue 00000000 
IDB address 80001814 

Interrupt Data Block (IDB) 80001814 

CSR address 00000000 Owner UCB addr. 00000000 ADP address 00000000 
Number of units 6 

Driver Dispatch Table (DDT) 800019AC 



Errlog buf sz 





Diag buf sz 





FDT size 


64 


Start I/O 


80001DC2 


Register dump 


return 


FDT address 


800019E4 


Alt start I/O 


return 


Unit init 


return 


Mnt verify 


8000CF43 


Cancel I/O 


80001AF8 


Unsol int 


return 


Cloned UCB 


return 
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USING THE SYSTEM DUMP ANALYZER <SDA) 



MBAl 

Device status: 
Characteristics: 



Unknown 

00000110 online, bsy 

0C150001 rec.shr.avl ,mbx, Idv.odv 

00000200 nnm 



UCB address: 800014EB 



PID 
Class/Type 
Def. buf. size 
DEVDEPEND 
DEVDEPND2 
FIPL/OIPL 
Charge PIO 



) 1,000004] 


Operation 


count 


17 


ORB address 


8000157B 


00000000 


Error count 







DOB address 


B00013BC 


AO/00 


Reference 


count 


2 


DOT address 


B00019AC 


1024 


BOFF 






0000 


CRB address 


80001614 


00000000 


Byte count 






0400 


IRP address 


B0240C20 


00000000 


SVAPTE 




00000000 


Fork R4 


0000003C 


OB/OB 


DEVSTS 






0001 


I/O wait queue empty 


00000000 














I/O request 


queue 













STATE 



IRP 



PID MODE CHAN FUNC WCB EFN AST 



IOSB 



STATUS 



8024DC20 00010006 U FFDO 0021 00000000 000025F8 00001004 0403 
readlblk buf io.func.mbxio 



MBA 2 



Unknown 



UCB address: 8000 15D0 



Device status: 00000110 online, bsy 
Characteristics: 0C150001 rec .shr.avl ,mbx , Idv.odv 
00000200 nnm 



Owner UIC [0000 


01,000004] 


Operation 


count 


12 


ORB address 


80001660 


PIO 


00000000 


Error count 







DOB address 


B00013BC 


Class/Type 


AO/00 


Reference 


count 


2 


DOT address 


8000 19AC 


Def. buf. size 


2560 


BOFF 






0000 


CRB address 


80001814 


DEVDEPEND 


00000000 


Byte count 






OAOO 


IRP address 


802509A0 


0EVDEPND2 


00000000 


SVAPTE 




00001 


Fork R4 


00000014 


FIPL/DIPL 


OB/OB 


DEVSTS 






0001 


I/O wait queue empty 


Charge PID 


00000000 
I/O request 


queue 













STATE 
C 



IRP 



PID MODE CHAN FUNC 



WCB 



802509A0 00010005 U FFDO 0021 00000000 
readlblk buf Io.func.mbxio 



EFN AST IOSB STATUS 
3 00000000 7FF9D5A4 0403 
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USING THE SYSTEM DUMP ANALYZER (SDA) 



MBA3 



MBX 



UCB address: 



80154B30 



Device status: 00000010 online 

Characteristics: OC150001 rec, shr ,avi ,mbx , Idv.odv 
00000200 nnm 



Owner UIC 


[000010.000040] 


Operation count 





ORB 


address 


80154BC0 


PIO 




00000000 


Error count 





DDB 


address 


800013BC 


Class/Type 




AO/01 


Reference count 





DDT 


address 


8000 19AC 


Def. buf . 


size 


IB 


BOFF 


0000 


CRB 


address 


80001814 


DEVDEPEND 




00000000 


Byte count 


0000 


LNM 


address 


80112BE0 


0EVDEPND2 




00000000 


SVAPTE 00000000 


I/O 


wait queue empty 


FIPL/DIPL 




OB/OB 


DEVSTS 


0001 








Charge PIO 




00000000 













*** I/O request queue Is empty *** 



MBA4 



MBX 



UCB address: 80162C90 



Device status: 00000110 online, bsy 
Characteristics: 0C150001 rec.shr.avi .mbx , idv.odv 
00000200 nnm 



Owner UIC 


[000001.000004] 


Operation count 


117 


ORB 


address 


80162D20 


PID 


00000000 


Error count 





DDB 


address 


800013BC 


Class/Type 


AO/01 


Reference count 


4 


DDT 


address 


8000 19AC 


Def. buf. 


size 150 


BOFF 


0000 


CRB 


address 


80001814 


DEVDEPEND 


00000000 


Byte count 


0096 


LNM 


address 


8013FAA0 


DEVDEPND2 


00000000 


SVAPTE 00000000 


IRP 


address 


8023E6C0 


FIPL/DIPL 


OB/OB 


OEVSTS 


0002 


I/O 


wait quei 


je empty 


Charge PID 


00010009 














PID MODE 


I/O request 


queue 


AST 


IOSB 




STATE IRP 


CHAN FUNC WCB 


EFN 


STATUS 



C 8023E6C0 00010009 K FFCO 0021 00000000 2 0000C581 0000A480 0403 
read lb Ik buf io.f unc .mbxio 
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USING THE SYSTEM DUMP ANALYZER (SDA) 



MBAS 



MBX 



UCB address: 80163E70 



Device status t 00000110 onHm.biy 
Characteristic*! 0C150001 rec.shr.avl .mbx.ldv.odv 
00000200 nnm 



Owner UIC [000001,000004] 

PID 00000000 

Clase/Type AO/01 

Def. buf. size 256 

DEVDEPEND 00000000 

0EVDEPN02 00000000 

FIPL/OIPL OB/OB 

Charge PID 0001000A 



Operation count 6 

Error count 

Reference count 2 

BOFF 0000 

Byte count 0040 
SVAPTE 00000000 

DEVSTS 0002 

I/O requeat queue 



ORB address 
ODB address 
DOT address 
CRB address 
IRP address 



80163F00 
800013BC 
800019AC 
80001814 
B0250660 



I/O wait queue empty 



STATE IRP 



PID 



MODE CHAN FUNC WCB 



C 80250660 0001000A U FF80 0021 00000000 
readlblk buf 1o,f unc.mbxlo 



EFN AST IOSB STATUS 
2 00001C8E 00001680 0403 



MBA 24 



MBX 



Device status: 00000110 online, bay 
Characteristics: 0C150001 rec .shr.avl ,mbx , Idv.odv 
00000200 nnm 



Owner UIC [000100,000025] 



PID 
Class/Type 
Def. buf. size 
DEVDEPEND 
DEVDEPND2 
FIPL/DIPL 
Charge PID 



00000000 

AO/01 

64 

00000000 

00000000 
OB/OB 

0001000F 



Operation count 

Error count 

Reference count 2 

BOFF 0000 

Byte count 0040 
SVAPTE 00000000 

OEVSTS 0002 



UCB address; 80165010 



ORB address 
DDB address 
DDT address 
CRB address 
IRP address 



801650A0 
800013BC 
800019AC 
80001814 
8024E920 



I/O wait queue empty 



STATE IRP 



I/O request queue 



PID MODE CHAN FUNC 



WCB 



EFN 



AST 



IOSB 



STATUS 



C S024E920 0001000F U FFCO 0021 00000000 3 00003457 00015030 0403 
readlblk buf lo.f unc.mbxlo 
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USING THE SYSTEM DUMP ANALYZER (SDA) 



2.6 Looking at RT Devices 

2.6.1 SDA> SHOW DEVICE RT 




> 



u 



* 



"^ 





Control ler 


DOB 1 


is 


t 

Driver 

RTTDRIVER 
CTDRIVER 




Address 


ACP 

REMACP 
REMACP 




DPT DPT size 


80283B00 
802B4160 


RTA 
RTB 


80165A60 0A20 
80166710 1A60 



Control ler : RTA 

Device Data Block (DDB) 802B3B00 

Driver name RTTDRIVER Alloc, class DDT address 
ACP ident REM SB address 80000EF4 

ACP class SLOW UCB address 80165350 

Primary Channel Request Block (CRB) 802B3BC0 

Reference count 2 Wait queue empty 

IOB address 802B3CE0 Int. service 

Interrupt Data Block (IDB) 802B3CE0 

CSR address 00000000 Owner UCB addr. 00000000 ADP address 
Number of units 8 

Driver Dispatch Table (DDT) 80165AEC 



Errlog buf sz 
Start I/O return 
Alt start I/O return 
Cancel I/O 80166052 

RTAO 



Diag buf sz 
Register dump 
Unit init 
Unsol int 





return 

return 

801660F8 



Unknown 



FDT size 
FDT address 
Mnt verify 
Cloned UCB 

UCB address: 



80165AEC 

80165FBF 
00000000 



64 

80165B24 

8000CF43 

return 

80165350 



Device status: 00000000 

Characteristics: OC040007 rec ,ccl , trm.avl , idv ,odv 

00000204 rtt.nnm 
Owner UIC [000001,000004] Operation count 



PIO 
Class/Type 
Def. buf. size 
DEVOEPEND 
DEVDEPND2 
FIPL/DIPL 



00000000 

42/00 

80 

180012AO 

00000000 

08/08 



Error count 

Reference count 

BOFF 

Byte count 

SVAPTE 

DEVSTS 









0000 

0000 

00000000 

0000 



ORB address 80165488 
DDB address 802B3BOO 
DDT address 80165AEC 
CRB address B02B3BC0 
I/O wait queue empty 



*** I/O request queue is empty *** 



Volume Control Block (VCB) B0164230 
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LA 24 



00000010 on Una 



RTA1 

Device status* 
Characteristics: 0C0C0007 
00000204 
Owner UIC (000001,000004] 
PID 00010017 
Class/Type 42/25 
Def. buf. size 132 
D6VDEPEND 420803A0 
DEV0EPND2 00800000 
FIPL/DIPL 08/08 

•** I/O request queue Is empty *•* 



recce 1 , trm.avl ,mnt , 


, 1dv,odv 


rtt ,nnm 




Operation count 


318 


Error count 





Reference count 


2 


BOFF 


0000 


Byte count 


0000 


SVAPTE 00000000 


DEVSTS 


0001 



UCB address; 8016A6B0 



ORB address 8016A7E8 
DOB address 802B3B00 
DOT address 8018B7A4 
VCB address 80164230 
CRB address 802B3BC0 
I/O wait queue empty 



Volume Control Block (VCB) 80164230 --- 



Controller: RTB 



Driver name 
ACP 1dent 
ACP class 



Device Data Block (DDB) 802B4160 

CTDRIVER Alloc, class DDT address 801667A4 

REM SB address 80000EF4 

SLOW UCB address 80164D90 



--- Primary Channel Request Block (CRB) 802B44C0 - 
Reference count 1 Walt queue empty 
IDB address 802B4400 Int. service 

Interrupt Data Block (IDB) 802B4400 -- 



80167139 



CSR address 00000000 
Number of units 8 
Err log buf sz 
Start I/O return 
Alt start I/O return 



Cancel I/O 



801672B9 



Owner UCB sddr. 00000000 AOP address 00000000 



D1ag buf sz 
Register dump return 
Unit 1n1t return 
Unsol Int 801675C3 



FDT size 
FDT address 
verify 



Mnt 



Cloned UCB 



64 

801667DC 

8000CF43 

return 



RTBO 



Unknown 



UCB address: 



80164D90 



Device status: 



00000800 valid 



Characteristics: 0C040007 rec.ee 1 , trm.avl , 1dv,odv 

00000004 rtt 
Owner UIC [000001,000004] 
PID 00000000 
Class/Type 42/00 
Def. buf. size 80 
DEVDEPENO 180012A0 
DEVDEPND2 00000000 
FIPL/DIPL 08/08 

**• I/O request queue Is empty •»* 



Operation count 





Error count 





Reference count 





BOFF 


0000 


Byte count 


0000 


SVAPTE 00000000 


DEVSTS 


0000 



ORB address 80164EC6 
DDB address 802B4160 
DOT address 801667A4 
CRB address 8O2B44C0 
I/O wait queue empty 
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2.7 Looking at Specific UCBX 
2.7.1 UCB for NETDRIVER 



SDA> FORMAT BO 162020 


!UCB for NETO 


80162020 


UCBSL FQFL 
UCBSL RQFL 
UCBSW MB SEED 
UCB$W~UNIT SEED 


0000003F 




80162024 


UCB$L~FQBL~ 
UCBSL RQBL 


00000000 




80162028 


UCBSW SIZE 


0090 




8016202A 


UCBSB TYPE 


10 




8016202B 


UCBSB FIPL 


08 




8016202C 


UCBSL ASTQFL 
UCB$L~FPC 
UCBST PARTNER 


8016202C 




80162030 


UCB$L~ASTQBL 
UCBSL FR3 


B016202C 




80162034 


UCB$L~FIRST 
UCBSL FR4 
UCBSW MSGMAX 
UCBSW MSGCNT 


00000000 




80162038 


UCB$W~BUFQU0 
UCBSW DSTAOOR 


0000 




8016203A 
8016203C 


UCBSW SRCAOOR 
UCBSL ORB 


0000 
B01620BO 


A< 


80162040 


UCBSL CPIO 
UCBSL LOCKIO 


oooooogo__ 




-' — 


y *, 


80162044 


UCB$L~CRB 


802A7920 




80162048 


UCBSL ODB 


8O2A7BC0 




8016204C 


UCB$L~PID 


00000000 




80162050 


UCBSL LINK 


80162D80 




80162054 


UCBSL VCB 


80162E90 




80162058 


UCBSL DEVCHAR 
UCBf}~DEVCHAR 


0C1C2000 




8016205C 


UCBSL DEVCHAR2 


00000000 


Ao*- 


80162060 
80162061 


UCbSB DEVCLASS 
UCB$B~DEVTVPE 


00 
00 _^— 


80162062 


UCBSW OEVBUFSIZ 


0100 -^ 




80162064 


UCBSB~LOCSRV 
UCBSB~SECTORS 
UCBSL DEVOEPENO 
UCB$L~JNL SEQNO 
UCBSQ DEVOEPENO 


01 
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80162065 


UCBSB REMSRV 
UCB$B~TRACKS 


00 


80162066 


UCB$W~BYTEST0G0 
UCBSW~CYLINDERS 
UCBSB VERTSZ 


0000 


80162068 


UCB$L~OEVOEPN02 
UCB$L~TT DEVOP1 


00000000 


8016206C 


UCB$L~IOQFL 


8016206C 


80162070 


UCB$L - I0QBL 


8016206C 


80162074 


UCB$W~UNIT 


0000 


80162076 


UCBSB CM1 
UCBSW CHARGE 
UCBSW RWAITCNT 


00 


80162077 


UCB$B~CM2 


00 


80162078 


UCB$L~IRP 


00000000 


8016207C 


UCBSW REFC 


0000 


B016207E 


UCBSB OIPL 
UCBSB STATE 


08 


8016207F 


UCBSB AMOD 


00 


80162080 


UCBSL~AMB 


00000000 


80162084 


UCB$L~STS 
UCBSW STS 


00002010 


80162088 


UCBSW OEVSTS 


0000 


8016208A 


UCBSW QLEN 


0000 


8016208C 


UCBSL OUETIM 


00000000 


80162090 


UCB$L~OPCNT 


00000000 


80162094 


UCBSL LOGADR 
UCBSL SVPN 


00000000 


80162098 


UCBSL~SVAPTE 


00000000 


8016209C 


UCBSW BOFF 


0000 


8016209E 


UCB$W~BCNT 


0000 


801620A0 


UCBSB ERTCNT 


00 


801620A1 


UCBSB ERTMAX 


00 


801620A2 


UCB$W~ERRCNT 


0000 


801620A4 


UCBSL JNL MCSID 
UCBSL POT 


00000000 


801620A8 


UCBSL DOT 


8015E5B0 


801620AC 


UCBSL MEDIA 10 
UCBSC LENGTH 


00000000 



5-32 



USING THE SYSTEM DUMP ANALYZER (SDA) 



2.7.2 UCBforNETACP 



O& 



vo 



HP*' 



SOA> FORMAT 80162D80/TVPE=UCB 



80162060 


UCBSL FQFL 




UCBSL RQFL 




UCB$W MB SEED 




UCB$W UNIT SEED 


B0162D84 


UCBSL FQBL 




UCBSL RQBL 


80162DB8 


UCBSW SIZE 


8016208A 


UCBSB TYPE 


80162D8B 


UCBSB FIPL 


80162O8C 


UCBSL ASTQFL 




UCBSL~FPC 




UCBST PARTNER 


80162D90 


UCBSL ASTQBL 




UCBSL FR3 


80162094 


UCB$L~FIRST 




UCBSL FR4 




UCBSW MSGMAX 




UCBSW MSGCNT 


80162098 


UCBSW BUFQUO 




UCBSW OSTAODR 


80162D9A 


UCBSW SRCAODR 


B016209C 


UCBSL ORB 


80162OA0 


UCBSL CPIO 




UCBSL LOCKID 


801620A4 


UCB$L~CRB 


801620A8 


UCBSL DOB 


80162DAC 


UCBSL PIO 


80162OB0 


UCBSL LINK 


80162DB4 


UCBSL VCB 


80162DB8 


UCBSL DEVCHAR 




UCBSQ DEVCHAR 


80162DBC 


UCBSL DEVCHAR2 


80162DC0 


UCBSB DEVCLASS 


80162DC1 


UCBSB DEVTYPE 


80162OC2 


UCB$W~DEVBUFSIZ 


80162DC4 


UCBSB LOCSRV 




UCBSB SECTORS 




UCBSL OEVOEPEND 




UCB$L~JNL SEQNO 




UCBSQ DEVDEPEND 



!UCB for NET1 
80162080 

80162080 

0090 
10 
08 
00000000 

00000000 
00000000 



0000 

0000 

80162E10 

00010009 

B02A7920 
802A7BC0 
00010009 
80163C60 
80162E90 
0C1C2000 

00000000 
00 
00 

0100 

01 
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80162DC5 


UCB$B REMSRV 
UCB$B~TRACKS 


00 


S0162DC6 


UCB$W~BVTEST0G0 
UCB$W CYLINDERS 
UCB$B~VERTSZ 


0000 


801620CB 


UCB$L~0EV0EPND2 
UCBSL~TT DEVDP1 


00000000 


80162DCC 


UCB$L~I0QFL 


80162OCC 


8O162DD0 


UCB$L~I0QBL 


80162DCC 


80162DD4 


UCB$W~UNIT 


0001 


80162006 


UCBSB CM 1 
UCB$W CHARGE 
UCBSW RWAITCNT 


90 


80162DD7 


UCBSB CM2 


00 


80162008 


UCBSL IRP 


00000000 


8016200C 


UCB$W~REFC 


0001 


80162OOE 


UCB$B~DIPL 
UCB$B~STATE 


08 


80162D0F 


UCBSB AMOD 


00 


80162DE0 


UCBSL AMB 


80162C90 


801620E4 


UCB$L~STS 
UCBSW ST5 


00010010 


801620E8 


UCB$W~0EVSTS 


0002 


801620EA 


UCB$W QLEN 


0000 


80162DEC 


UCBSL DUETIM 


00000000 


80162OF0 


UCBSL OPCNT 


00000000 


801620F4 


UCB$L~LOGADR 
UCBSL SVPN 


00000000 


801620FB 


UCB$L~SVAPTE 


00000000 


80162DFC 


UCBSW BOFF 


0000 


801620FE 


UCBSW BCNT 


0000 


80162E00 


UCBSB ERTCNT 


00 


80162E01 


UCBSB ERTMAX 


00 


80162E02 


UCBSW ERRCNT 


0000 


80162E04 


UCB$L~JNL MCSID 
UCBSL POT - 


00000000 


80162E08 


UCBSL~DOT 


8015E5B0 


80162E0C 


UCBSL MEDIA ID 
UCBSC LENGTH 


00000000 
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2.7.3 UCBforFAL 



SDA> FORMAT 801654E0 


!UCB for NET30 


801654E0 


UCBSL FQFL 
UCB$L~RQFL 
UCB$W~MB SEEO 
UCBSW UNIT SEEO 


801654E0 


B01654E4 


UCBSL FQBL 
UCBSL RQBL 


8016S4E0 


801654EB 


UCBSW SIZE 


0090 


801654EA 


UCBSB TYPE 


10 


801654EB 


UCBSB FIPL 


08 


801654EC 


UCBSL ASTQFL 
UCB$L~FPC 
UCBST PARTNER 


00000000 


801654F0 


UCBSL ASTQBL 
UCBSL FR3 


00000000 


801654F4 


UCBSL FIRST 
UCBSL~FR4 
UCBSW MSGMAX 
UCBSW MSGCNT 


00000000 


801654F8 


UCBSW BUFQUO 
UCBSW DSTADDR 


0000 


801654FA 


UCBSW SRCADOR 


0000 


801654FC 


UCBSL ORB 


80165570 


80165500 


UCB$L~CPID 
UCBSL LOCKID 


0001000F 


80165504 


UCBSL CRB 


802A7920 


80165508 


UCBSL DOB 


802A7BC0 


8016550C 


UCBSL PIO 


0001000F 


80165510 


UCBSL LINK 


8016S5DO 


80165514 


UCBSL VCB 


80162E90 


80165518 


UCBSL DEVCHAR 
UCBSQ DEVCHAR 


0C1C2000 


8016551C 


UCBSL DEVCHAR2 


00000000 


80165520 


UCBSB DEVCLASS 


00 


80165521 


UCBSB DEVTVPE 


00 


80165522 


UCB$W~DEVBUFSIZ 


0100 


80165524 


UCBSB LOCSRV 
UCBSB SECTORS 
UCBSL DEVDEPEND 
UCBSL JNL SEQNO 
UCBSQ DEVDEPEND 


01 
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80165525 


UCB$B REMSRV 
UCB$B TRACKS 


00 


80165526 


UCB$W BYTESTOGO 
UCBSW CYLINDERS 
UCB$B~VERTSZ 


0000 


8016S528 


UCB$L~DEVDEPND2 
UCB$L~TT 0EVDP1 


00000000 


B016552C 


UCB$L"*I0QFL 


8016552C 


B0165530 


UCBSL IOQBL 


8016552C 


80165534 


UCB$W~UNIT 


001E 


80165536 


UCB$B CM1 

UCB$W~CHARGE 

UCB$W~RWAITCNT 


90 


80165537 


UCB$B CM2 


00 


80165538 


UCBSL IRP 


00000000 


8016553C 


UCBSW REFC 


0001 


8016553E 


UCBSB DIPL 
UCB$B STATE 


08 


8016553F 


UCB$B~AMOD 


00 


80165540 


UCBSL AMB 


80165010 


80165544 


UCBSL STS 
UCBSW STS 


00010010 


80165548 


UCBSW DEVSTS 


0002 


8016554A 


UCBSW QLEN 


0000 


8016554C 


UCBSL DUETIM 


00000000 


80165550 


UCBSL OPCNT 


00000007 


80165554 


UCB$L~L0GADR 
UCBSL SVPN 


00000000 


80165558 


UCBSL SVAPTE 


802AAEC0 


8016555C 


UCBSW BOFF 


0058 


B016555E 


UCBSW BCNT 


0005 


80165560 


UCBSB ERTCNT 


00 


80165561 


UCBSB ERTMAX 


00 


80165562 


UCBSW ERRCNT 


0000 


80165564 


UCB$L~JNL MCSID 
UCBSL PDT 


00000000 


80165568 


UCBSL DDT 


8015E5B0 


8016556C 


UCBSL MEDIA ID 
UCB$C*~LENGTH 


00000000 
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2.8 Using SDA to Look at Routing Data Structures 
2.8.1 Routing Control Block 

SDA> FORMAT B0162E90/TYPE=RCB 



80162E90 
80162E94 
80162E98 
80162E9A 
80162E9B 
80162E9C 
80162E9E 
B0162EA0 
80162EA4 
80162EA8 
80162EAC 
80162EB0 
B0162EB4 
80162EB8 
80162EBC 
80162EC0 
80162EC4 
80162EC8 
80162ECC 
80162ED0 
80162ED4 
80162ED8 
80162E0C 
80162EE0 
80162EE4 
80162EE8 
80162EEA 
80162EEC 
80162EEE 
80162-rT 
80162FFi 
80162EK2 
80162EF3 
80162EF4 
80162EF5 
80162EF6 
80162EF7 
80162EF8 
80162EF9 
80162EFA 
80162EFB 



RCB$Q IRP FREE 



RCB$W 
RCBSB* 

rcbsb* 

RCBSW" 
RCBSW* 
RCBSL" 

rcbsl" 
rcbsl" 
rcb$l" 
rcbsl" 
rcbsl" 
rcbsl" 
rcbsl" 
rcbsl" 
rcbsl" 
rcbsl" 
rcbsl" 
rcbsq" 



SIZE 

TYPE 

STATUS 

TRANS 

ADDR 

AQB 

ACP_UCB 

PTR_JNX 

PTR_0A 

PTRAOA 

PTRJ-TB 

PTR LPO 

PTR""ADJ 

PTRTQE 

PTR_NDC 

PTR_DCS 

PTR_AREG 

LOC RCV 



RCB$Q_LOC_XMT 
RCBSQ IRP WAIT 



RCBSW 

RCBSW 

RCBSW* 

RCBSW" 

RCBSB" 

rcbsb" 

RCBSB' 
RCBSB" 

rcbsb" 

RCBSB* 

rcbsb" 

rcbsb" 

rcbsb" 

rcbsb 

rcbsb" 

rcbsb" 



MCOUNT 

"CURJ-LNK 

MAX_LNK 

MAX_ADDR 

MAX LPO 

MAX~SNK 

MAX_VISIT 

INT PTH 

ACT~DLL 

ST I 

ECL_RFLW 

ECL RFA 

ECL*"DFA 

ECL_DWE 

ECLJDAC 

ECL DPX 






8024CD80 

80250180 

0000 

11 — > AV^"> 

02 , ^ 

0006 " r *v* 

0402 

80162E70 
80162080 
00000000 

802A62AC „. .^^tc 
00000000 m****-<~ <a 
80162FF0 
802A912B 
801634D8 
80162FC0 

80163120 „ vo*V3«"~> «i"-' 

00000000 '•" : ^ . w 

00000000 «A ^ M xrc\o^< 

8024AB60 
8024AB60 
80162EO8 
80162E08 
80162EE0 
80162EE0 
0006 
0005 

0040 
000F 

OB 
OB 
OA 
00 

02 
01 
08 
OA 

05 
05 
03 
03 



,Vu<^W^ 



\\ cA^ 1 



.*, ^°^ 



*v ^ vt< 



•rtaS J 






c 



A 



>"> 
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B0162EFC 


RCBSW MAX ADJ 


006B 


80162EFE 


RCB$W MAX~RTG 


002B 


80162F00 


RCB$L~DLE~XWB 


OOOOOOOO 


80162F04 


RCB$W~TIM~RSI 


0000 


80162F06 


RCBSW TIM~RTI 


0000 


80162F08 


RCBSW TIM IAT 


003C 


80162F0A 


RCB$W~TIM CNI 


002D 


B0162F0C 


RCBSW TIM~CNO 


0020 


80162F0E 


RCBSW TIM CTI 


0000 


80162F10 


RCB$W~ECLSEGSIZ 


0231 


80162F12 


RCBSW TOTBUFSIZ 


028C 


80162F14 


RCBSW CUR PKT 


0003 


80162F16 


RCBSW MAX PKT 


OOOF 


80162F18 


RCB$W~PKT~FREE 


0000 


80162F1A 


RCBSW PKT~PEAK 


0000 


80162F1C 


RCBSB PKT FAIL 


00 


80162F1D 


RCBSB MEM FAIL 


00 


80162F1E 


RCBSB ETV 


04 


80162F1F 


RCBSB HOMEAREA 


01 


80162F20 


RCBSB MAX AREA 


3F 


80162F21 


RCBSB ACT TIMER 


17 


80162F22 


RCBSW ALIAS 


0000 


80162F24 


RCBSW MAX ALNK 


0020 


80162F26 


RCB$W~MAX~LLNK 


0020 


80162F28 


RCBSW CUR ALNK 


0000 


80162F2A 


RCBSL^ABSJTIM 


012B 


80162F2C 




0000 


80162F2E 


RCBSB CNT 1ST 
RCBSB CNT NOL 


00 


80162F2F 


RCBSB CNT APL 


00 


80162F30 


RCBSB CNT~OPL 


00 


80162F31 


RCBSB CNT~PFE 


00 


80162F32 


RCB$B~CNT RUL 


00 


80162F33 


RCBSB CNT VER 


00 


80162F34 


RCBSW CNT~NUL 


0000 


80162F36 


RCB$W~CNT~XRE 


0000 


80162F38 


RCBSW CNT MLL 


0007 


80162F3A 


RCB$Q~CXB_FREE 


2F3A 


80162F3C 




2F3A8016 


80162F40 




8016 


80162F42 


RCBSB LSN ADJ 


00 


80162F43 


RCBSB AQB CNT 


00 


80162F44 


RCBSW DRT 


0000 


80162F46 


RCBSW LVL2 
RCBSC LENGTH 


0000 
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2.8.2 Output Adjacency 



rf 



0<f> 



vP ! 



0<&> 



,4 SDA> EXAMINE 802A62AC:20 



v$? oooooooc oooeooof oooooooi oooripooi 

-.6 00000000 00000000 00000000 00000000 



^ ! OUTPUT ADJACENCY (MAX ADDRESS* IS) 



802A62AC 
802A62BC 



2.8.3 Looking at Specific Node Entries 



SDA> EXAMINE 802A62AC 
802A62AC: 000D0001 



!node 



(local node) 



SDA> EXAMINE 802A62AC + 2 !SPLASH=1.1 (with 2 bytes per entry) 

802A62AE: 00010000 " " 



SDA> EXAMINE 802A62AC + 4 
802A62B0: 00000001 " " 



!THUD=1.2 (local node) 



SDA> EXAMINE 802A62AC + 6 
802A62B2: 000F0000 " " 



SDA> EXAMINE 802A62AC + 8 
802A62B4: OOOEOOOF 

SDA> EXAMINE 802A62AC + A 
802A62B6: 0O0C000F " " 



! ZIP- 1.3 (unreachable node) 



•BAROOM-1.4 



i^o 



!CLICK=1.5 




"i 



<1(& 
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USING THE SYSTEM DUMP ANALYZER (SDA) 



2.8.4 Adjacency Index Table 



~? 



J 



PU. 'V 






SDA> EXAMINE 801634D8{50 1 !ADJ INOEX TABLE (from RCB) 

^ 1/ i >o 

801636BA 801636AD 801636AO 001707BD 80163408 

801636EE B01636E1 801636D4 801636C7 801634E8 

80163722 80163715 80163708^801636FB 801634F8 

80163756 80163749 8016373C'8016372F 80163508 

8016378A 8016377D 80163770 80163763 80163518 

SDA> EXAMINE 801634D8+34 IOFFSET 0*4(SPLASH) INTO TABLE FOR ADJ ADDRESS 
80163508: 8016373C "/7.." \ ^iV 

SDA> EXAMINE 801634D8+38 IOFFSET E»4 (CLICK) INTO TABLE FOR ADJ ADDRESS 
80163510: 80163749 "17.." 



V? 



SDA> FORMAT 



8016372F 
80163730 
80163731 

80163732 
80163733 
80163735 
80163737 
80163739 
8016373B 



8016373C /TVPE=ADJ 

ADJ$B_STS 

ADJ$B_PTVPE 

ADJ$B_LPD_INX 

ADJ$W_LPD 

ADJ$B_LPD SEQ 

ADJ$W_PNA~ 

adj$w_bufsiz 
adjsw int lsn 
aojsw^tim'lsn 
adj$b_bcpri 
aojsc length 



\ 
-04 



tt OF 



03 



02 



3~ 



0401 



05DA 



002D 



0027 



40 




^> fV 



^ 



■^ 



— >i "^ 



-^ 



^ 



^ U 



ir, ~~ \ 



\ 



SDA> FORMAT 80163749 /TYPE=ADJ 



80163749 


ADJSB STS 


8016374A 


ADJSB PTVPE 


8016374B 


ADJSB LPD I NX 




ADJSW LPD 


B016374C 


ADJSB LPD SEQ 


80163740 


ADJSW PNA 


8016374F 


ADJSW BUFSIZ 


80163751 


ADJSW INT LSN 


80163753 


ADJSW TIM LSN 


80163755 


ADJSB BCPRI 




ADJSC LENGTH 



OF 



04 



03 



02 



0405 



0240 



002D 



0021 



40 
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2.8.5 Logical Path Descriptor 



\& c - 



V 



!LPO TABLE INDEX (from RCB) 



80244290 80162P50 00170050 
00000106 00000105 00000104 
00000 10A 00000109 00000108 
0000010E 00000100 0000010C 
802A7O40 00000111 00000110 



SDA> EXAMINE 802A9128;50 

80243E80 
00000107 
00000 108 
0000010F 
010B7324 



802A9128 
802A9138 
802A9148 
802 A9 158 
802A9168 



SDA> EXAMINE 802A9128+C 
802A9134: 80243EB0 



•LPD TABLE INDEXED BV 3*4 BVTES 
iuse ADJSB LPD INX (ctcuU Is UNA-O) 






SDA> FORMAT 80243E80/TYPE=LPD 


!for UNA-0 


80243EB0 


LPD$Q_REQ_WAIT 


8^243E80 


80243E84 




80243E80 


80243E88 


LPDSW SIZE 


006A 


80243E8A 


LPDSB TYPE 


17 


80243EBB 


LPDSB STARTUPS 


01 


80243E8C 


LPDSL WIND 


00000000 


80243E90 


LPD$L~UCB 


80164320 


80243E94 


LPDSW CHAN 


0090 


80243E96 


LPD$W~TIM TLK 


OOOA 


80243E98 


LPDSW INT TLK 


OOOF 


80243E9A 


LPDSB TSTCNT 


00 


80243E9B 


LPDSB ASTCNT 


01 


80243E9C 


LPD$B~IRPCNT 


01 


80243E9D 


LPDSB ETY 


04 


80243E9E 


LPDSB KMT SRL 


OB 


80243E9F 


LPD$E."XMT~IPL 


06 


80243EA0 


LPD$B~PTH INX 
LPDSW PTH 


03 


80243EA1 


LPDSB PTH SEQ 


02 


80243EA2 


LPDSW STS 


2471 


80243EA4 


LPDSB XMTFLG 


00 


80243EA5 


LPD$B~PVCFLQ 


00 


80243EA6 


LPDSB STI 


09 


80243EA7 


LPDSB SUB STA 


OA 


80243EA8 


LPOSB PLVEC 


7F 


80243EA9 


LPD$B~C0ST 


01 


80243EAA 


LPDSB BCPRI 


40 


80243EAB 




00 







v w 









■we-^ 
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80243EAC 
80243EAE 
80243EB0 
80243EB2 
S0243EB4 
80243EB6 
80243EB8 
80243EBA 

80243E8B 
B0243EBC 
80243EBE 
80243EC0 
80243EC2 
80243EC4 
80243EC6 
80243EC8 
80243ECA 
80243ECC 
80243ECE 
80243ECF 
80243E00 
80243ED2 
B0243E03 
80243ED4 
80243ED5 
80243E06 
80243E08 
80243EDA 
80243EDC 
80243EDE 
80243EE0 
80243EE2 
80243EE4 
80243EE6 
80243EE8 



LPD$W DRT 
LPD$L~RTR_LIST 

LPO$L_RCV_IRP 

LPD$L_ABS_T1M 

LPD$B CNT 1ST 
LPD$L~CNT~APR 



CNT_TPR 
CNT DPS 



LPOSL 
LPO$L 
LPDSL CNT TPS 



LPOSW 
LPDSW" 
LPD$B~ 
LPD$B" 

lpd$w" 

LPD$B~ 

lpo$b" 
lpdsb" 
lpd$b" 

LPD$G~ 
LPOSG. 
LPD$G_ 
LPD$G_ 
LPD$L_ 
LPDSC 



CNT_ACL 
"CNT_TCL 
"CNT_LDN 
"CNT IFL 
"BUFSIZ 
"SRM_POS 
"SRM LEFT 
~ASRM_POS 
"ASRM LEFT 
>RM ~ 

_XMT_SRM 

.ASRM 

,XMT_ASRM 

.CACHE 

LENGTH 



462C 
0000 



oooc 

8016 



0000 



013C 



0000 



E8 
02 



0000 



0000 

c 

0293 

c 

0000 

c 

0000 



0000 



0000 



0000 



0000 



00 



00 



050A 



13 



00 



00 



00 



0000 

c 

0000 



0000 



FFFF 



0000 
FFFF 



0000 

C 

0000 



0000 



0000 



•5* o^ 



v 






^ 
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2.9 Logical Link Data Structures 
2.9.1 Link Tables 



SOA> EXAMINE 80162FF0;120 



!LTB table for logical 
!size = header (36) ♦ 



links (from 
oaxl 1nk«(64) 



RCB) 
* 4 



003E0020 
0OOO0O0O 
04030001 
80165820 
040B0001 
040F0001 
04130001 
00170001 
001B0001 
001F0001 
00230001 
00270001 
002B0001 
002F0001 
00330001 
00370001 
003B0001 
FFFFFFFF 



0020003E 
80165820 
04020001 
08060001 
80169E90 
040E0001 
04120001 
00160001 
001A0001 
001E0001 
00220001 
00260001 
002A0001 
002E0001 
00320001 
00360001 
003A0001 
003E0001 



00000000 80163068 80162FFO 

00000000 01240000 80163000 

04010001 00000000 80163010 

04050001 04040001 80163020 

0809000180166480 80163030 

04000001 80169BF0 .,_..« . . 80163040, 

04110001 041000QlV T ^-«-v . :. 7 W1630'50 

8016A2A0 0414000r 80163060 

00190001 00180001 80163070 

00100001 00 1C0001 80163080 

00210001 00200001 80163090 

0025000100240001 801630A0 

0029000100280001 801630B0 

002D0001 002C0001 801630C0 

00310001 00300001 80163000 

0035000100340001 801630E0 

0039000100380001 801630F0 

003D0001 003C0001 80163100 



■ »v 



-A ^S^ 



SDA> FORMAT 80162FF0/TVPE=LTB 



80162FF0 LTB$L_SLT_NXT 80163068 

B0162FF4 LTB$L_ASLT_NXT 00000000 

80162FF8 LTB$W_SLT_TOT 003E 

80162FFA LTB$W_SLT_LMT 0020 

80162FFC LTB$W_ASLT_LMT 0020 

80162FFE LTBJW '. SLT_T0T 003E 

80163000 LTB$W~ASLT_TOT 0000 

80163002 LTBSw'SIZE 0124 

80163004 LTBSBJTYPE 00 

80163005 LTB$B_SPARE_1 00 

80163006 LTB$W_SPARE_2 0000 
80163008 LTB$L_XWB 80165820 
8016300C LTB$L_PTR_ALIAS_SL0TS 00000000 
80163010 LTB$L_SLOTS 00000000 

LTBSC LENGTH 






~> 



-a> 



"^ N^CP- 



r u^ 



: >A ;A " 



(&-* 



V 









$ 



5-43 



USING THE SYSTEM DUMP ANALYZER (SDA) 



2.9.2 Extended (NETWORK) Window Block 



SDA> FORMAT 80165820/TVPE=XWB 




80165820 


XWBSL WLFL 


80162E70 


80165824 


XWB$L WLBL 


80162E70 


80165828 


XWBSW SIZE 


017C 


8016582A 


XWB$B~TVPE 


1C 


8016582B 


XWBSB ACCESS 


00 


8016582C 


XWB$W REFCNT 


0001 


8016582E 


XWBSW STS 


1000 


80165830 


XWB$L ORGUCB 


801654E0 


80165834 


XWBSQFORK 


800029D0 


80165838 




800029D0 


8016583C 


XWBSW FLG 


02E0 


80165S3E 


XWB$B~STA 


05 


8016583F 


XWBSB FIPL 


08 


80165840 


XWB$L FPC 


801602DE 


80165844 


XWBSL FR3 


00000203 


80165848 


XWB$L FR4 


00000000 


8016584C 


XWBSL LINK 


80166480 


80165850 


XWBSL VCB 


80162E90 


80165854 


XWBSL PID 


0001000F 


80165858 


XWBSW PATH 


0203 


8016585A 


XWBSW REMNOD 


0401 


B016585C 


XWBSW REMLNK 


201F 


8016585E 


XWBSW LOCLNK 


0407 


80165860 


XWBSW LOCSIZ 


05B5 


80165862 


XWBSW REMSIZ 


05B5 


80165864 


XWBSW R REASON 


0064 


80165866 


XWBSW X REASON 


0064 


80165868 


XWBSW TIM 10 


0039 


8016586A 


XWBSW ELAPSE 


0011 


8016586C 


XWB$W - TIM INACT 


00 IE 


8016586E 


XWBSW DELAY 


0001 


80165870 


XWBSW TIMER 


0O0C 


80165872 


XWBSW PROGRESS 


0000 


80165874 


XWBSW RETRAN 


000A 


80165876 


XWBSW DLY FACT 


0005 


80165878 


XWBSW OLY WGHT 


0005 


8016587A 


XWBSB PRO 


19 


8016587B 


XWBSB DATA 


00 


8016587C 


XWB$T_DATA 




8016587D 




000000 


80165880 




00000000 


80165884 




00000000 


80165888 




00000000 


B016588C 


XWBSB X FLW 


00 



xo^ 
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80165880 
8016588E 
801658SF 
80165890 
80165890 
80165894 
80165898 
8016589C 
801658AO 
8016S8A4 
801658A8 
801658AC 
801658B0 
801658B4 
801658B8 
801658BC 
801658C0 
801658C4 

801658C5 
8016S8C6 
801658C8 
801658CC 
801658DO 
801658D4 
801658D8 
80165809 
801658DA 
801658DC 
801658EO 
801658E4 
801658E8 
801658EC 
801658EO 

8016=;3F5 
801650F8 
8016S8FC 
80165900 
80165904 
80165908 
8016590C 
80165910 



XWBSB X_FLWCNT 
XWB$B~SP3 
XWBSB RID 
XWBST~RID 



XWBSL IRP ACC 



00 



XWB$B_LPRNAM 
XWBST 0T 
XWB$T~LPRNAM 



XWBSBRPRNAM 
XWBST RPRNAM 



XWBSB LOGIN 
XWBST~LOGIN 
XWBST~LI 



00 
OC 

S44F4353 
20202054 
20202020 
20202020 
00000000 
00000000 
00010000 
00000001 
00000038 
00000052 
00000077 
00000077 
00000000 
03 



0003 

00030003 
60F00003 
00080001 
00000000 
00 

0000 

00000000 
8023C7E0 
00000000 
00030003 
00 



003900 

00390039 

00010039 

00000001 

00000000 

00000000 

00000000 

00000000 
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80165914 
80165918 
8016591C 
80165920 
80165924 
80165928 
8016592C 
80165930 
80165932 
80165934 
80165938 



XWB$L_DEA_IRP 

XWB$L ICB 
XWB$W~CI PATH 



XWB$Q_FREE_CXB 



00000000 
003A003A 
01000100 
801658C4 
00000000 
00000000 
00000000 
0203 
0000 

00000000 
80165938 
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2.10 Network Counter Data Structures 
2.10.1 Node Counter Block ^ ^ ^ *K 



SDA> EXAMINE 80163120; 100 



•NODE counter block (from RC8) 



0000012B 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
0000012B 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
0000012B 
00000000 



001703A8 00000021 0000001C 80163120 

00000000 00000000 00000000 80163130 

00000 12B 00000000 00000000 80163140 

00000000 00000000 00000000 80163150 

00000000 0000012B 00000000 80163160 

00000000 00000000 00000000 80163170 

00000000 00000000 00000 12B 80163180 

00000000 00000000 00000000 80163190 

00000000 00000000 00000000 801631A0 

00000 12B 00000000 00000000 801631B0 

00000000 00000000 00000000 80 163 ICO 

00000000 00000 12B 00000000 80163100 

00000000 00000000 00000000 B01631E0 

00000000 00000000 0000012B 8O1631F0 

00000000 00000000 00000000 80163200 

00000000 00000000 00000000 80163210 
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2.11 Notes on the SDA Trace 

1. The analysis was done with several logical links created 
to this node and to other nodes on the same Ethernet. 

2. The READ commands read the Network Data Structures and VMS 
System Data Structures files. -This allows easy formatting 
of data structures by SDA. 

3. The SHOW SUMMARY command finds out how many processes were 
running when the system crashed. 

4. The SHOW POOL/SUMMARY command gives information about 
structures called NET. These are DECnet data structures. 

5. The SHOW DEVICE XM command gives information on the 
DMC/DMR type devices and the SHOW DEVICE XE gives 
information on the ETHERNET DEUNA type devices. The 
information that is of particular interest is the UCB 
addresses. 

6. For the structures in the display, the header information 
gives the size and type of the data structure. 

Bytes 9 and 10 give the size of the data structure and 
byte 11 gives the type of data structure. 

The NET structures have type 17. 

7. The SHOW DEVICE NET command displays the UCB address of 
NETDRIVER. There can be many UCBs for NETDRIVER depending 
on network activity. 

Multiple UCBs have been highlighted for this example. The 
reason some of the numbers appear high is that each time 
the ASSIGN command is used to create a UCB for a NET 
device the number is incremented by one. 

8. The Routing Control Block (RCB) is pointed to by the VCB 
address of each of the NETn devices. 

From the RCB, most of the other data structures could be 
traced. The RCB address for this system is 80162E90. 
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9. The SHOW DEVICE MB command gives information about the 
mailbox drivers. The UCB values can be used to confirm 
the linkage between the NETDRIVER and MBDRIVER. 



NOTES 

The UCB of NET1 is at 80162080. The mailbox (AMB 
address or UCB$L_AMB) is 80162C90. 

This is the address of MBA4. 

NETl is NETACP and XEAl and XMAO also use this as 
their mailbox (AMB address). 



10. An example of the FORMAT command is shown using the UCB 
address of NETO (NETDRIVER). 

Each NETn device has the same value for the field which is 
the pointer to the RCB (UCB$L_VCB - 80162E90). 

11. The key data structure (RCB) is formatted. 

The fields of interest are: 

RCB$L_PTR_OA Output Adjaceny vector 

RCB$L_PTR_LTB Logical link table 

RCB$L_PTR_LPD Logical path descriptor 

RCB$L_PTR_ADJ Adjaceny node database block 

RCB$L_PTR_NDC Node counter block 

12. The Output Adjaceny vector (OA) is examined. 

The numbers are indices to entries in the Adjacency Node 
Database Block (ADJ). 



NOTE 

These numbers are in HEX so 0015 points to 
entry 21, 0016 to entry 22 and so on. 
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13. To check whether the destination node is reachable, the OA 
vector is used. If the destination node address is 5, for 
example, the fifth entry is checked. 

If the fifth entry contains zero, the destination is not 
reachable. An error message is returned to the source 
program. 

14. If the fifth entry is nonzero, it contains an offset to 
the ADJ. The ADJ identifies the logical path (circuit) on 
which to send the connect initiate message. 

15. The Adjaceny node database block (ADJ) is examined here. 

16. The addresses expanded are for node 1.1 (SPLASH) and 1.5 
(CLICK) . 

17. Information of interest includes the node type (PTYPE) , 
physical node address (PNA), buffer size (BUFSIZ) and 
(Broadcast) Router Priority (BCPRI). 

Node type 3 is a Phase IV Area Routing Node 
Node type 4 is a Phase IV Routing Node 
Buffer size 05DA = 1498 bytes. 

PNA = area * 1024 + node 

1.1 = 1024 + 1 = 1025 = 401 (HEX) 
1.5 = 1024 + 5 = 1029 = 405 (HEX) 



Buffer size for SPLASH = 5DA (HEX) ■ 1498 

(VAX on Ethernet) 
Buffer size for CLICK ■ 240 (HEX) = 576 

(PDP on Ethernet) 

18. The Logical Path Descriptor (LPD) table is examined. 

19. The LPD for the circuit used (UNA-0) is obtained by 
indexing into the table to ADJ$B_LPD_INX * 4 BYTES PER 
ENTRY. ADJ$B_LPD_INX is from the ADJ and it is 3 for both 
nodes examined, as they are on the same circuit. 

20. The Logical Path Descriptor (LPD) contains the UCB of the 
physical device. 
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21. To demonstrate the connection between the LPD and 

NETDRIVER, note that the LPD$L_UCB field points to the UCB 
of the XEAl. 

LPD$L_UCB will contain a UCB for the device used on that 
circuit (XM, XE, etc.). 



NOTE 

LPD$L_UCB s 80164320 which is the UCB 
of XEAl. 

22. The Logical Link Table (LTB) is examined, and LTB$L_XWB 
points to the XWB describing the first logical link. 

23. This XWB (§80165820) has been expanded. 

NOTE 

XWB$L_ORGUCB = 801654E0 which points to 
the UCB of NBT30 (FAL). The local link 
(407 HEX = 1031) and remote link number 
(201F HEX = 8223) also point to local 
process FAL_1031. 

24. The Node Counter block is examined. After the 12 byte 
header, it contains information about the local node (node 
0) and then the rest of the nodes. 

25. information in the Node Counter block is updated as 
network activity occurs. 
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MAJOR NETWORK MECHANISMS 

INTRODUCTION 

Some major DECnet mechanisms are reviewed. The flow of the actions 
are traced and the routines executed are referenced. 

Topics include: 

• Logical Link Creation 

• NSP Flow Control Mechanisms 

• Sending and Receiving Normal Data and Interrupt Data 

• Routing Table Update 

• Other Network Mechanisms 
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1 CREATING A LOGICAL LINK 

1.1 Operating Sequence of a Remote Network Access 

1. DCL command (for example, COPY) calls RMS on the local 
node 

2. RMS calls DECnet on the local node 

3. DECnet calls NETDRIVER which calls NETACP on the remote 
node 

4. NETACP creates the process on the remote node using access 
control information or proxy (runs SYS$ SYSTEM: LOGINOUT.EXE 
in the context of this process) 

- SYS$SYLOGIN: EXECUTES 

- SYS$ LOGIN iLOGIN.COM OR /LGICMD EXECUTES 

- F$MODE() ■ "NETWORK" 

- SYS$OUTPUT = SYS$ LOGIN: NETSERVER.LOG 

- SYS$ INPUT - NETSERVER.COM 

- SYS$SYSTEM:NETSERVER.COM runs SYS$SYSTEM:NETSERVER.EXE 

- NETSERVER.EXE calls LIB$DO_COMMAND or LIB$RUN_PROGRAM 
for the inbound connect request 

(PAL, MAIL, PHONE, user-specif ied procedure or image) 

- Returns to NETSERVER.COM which executes NETSERVER.EXE 
again (in the context of the current process) 

- Wait for NETS ERVER$ TIMEOUT for another inbound connect 
request 
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1.2 Sample DECnet-VAX Operation (Creating a Logical Link) 

• Logical links are established by an interaction of DECnet 
calls specified in two cooperating programs (SOURCE and 
TARGET) 

• The handshake procedure takes place in a prescribed order 

• Once established, there is no distinction between SOURCE 
and TARGET 

• The logical link is logically full-duplex! 

-dg • The logical link can be considered to comprise two 
£- separate data subchannels, each carrying messages in both 
o y directions ~ ^ 

^ i, °^> _ it? /. 

t"C°* ^ SENDING NORMAL DATA v ^ ^ x n ^> 

A ^V ^ ' =================== J* -^ J £ J 'v. ^> 

O 0? SYS$QI0iX ,%VAL(NET_CHAN) ,%VAL( IO$_WRITEVBLK) ,IOSB, , / 
" 1 \ DATA_ARRAY , %VAL( 512 ) , , , , ) 

SENDING INTERRUPT DATA 

SYS$QIOW( ,%VAL(NET CHAN), 

1 %VALTlO$_WRITEVBLK.OR.IO$M_INTERRUPT) ,IOSB, , , 

2 INT_MESSAGE,%VAL(16),,,,L V/a w-j 

• For a program to receive and process interrupt data, that 
program (SOURCE or TARGET) must create a mailbox and tie 
it to the network channel 

SYS$CREMBX( ,MBX_CHAN, , , , , 'NET_MBX' ) 

SYS$ASSIGN( '_NET}'NET_CHAN,'NET_MBX' ,) 
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1.3 Basic Steps in Nontransparent Task-to-Task Communication 

SOURCE TARGET 

sssaaa i»iu 

0c5 



1. Obtain network channel number . „ +,- 

SYS$ASSIGN(' NET:' , SRC CHAN,,) A^f 1 U 



^fc\ 



2. Request connect with TARGET 

(NCB) 

0$_ACCESS), ( 
IOSB,,,,NCB DESC,,,,) 



using Network Connect Block (NCB) ^ 

SYS$QI0W( ,%VAL(SRC_CHAN) ,%VAL( I0$_ACCESS) , t ^nec^ i*"^ v> €5 ^ 



3. image run in process created due v^^l^T* 
to connect request by SOURCE ^\\<*»^ % 

4. Obtain network channel number ^^ ,cw^ 
SYS$ASSIGN( '_NET: ' ,TGT_CHAN, , ) &< e^ M 

^J'J' ^V^V 5. Translate SYS$NET to obtain NCB 

v/ ( f °V t ^ SYS$TRNLNM( , • LNM$PILE_DEV' , • SYS$NET' , , I terns ) 



SYS$QI0W( ,%VAL(TGT CHAN) ,%VAL(Z0$ ACCESS) , i***" 



6. Accept/reject the connection with SOURCE 

VAL(TGT CHAN),tVAL(ZO$ ACCESS. . , 
IOSB, , ,7NCB, , , , ) ccM ^ k ct^ o^f 

7. SOURCE and TARGET may Send and Receive data - coordinating access 

/ I 'J SYS$QI0W( , %VAL ( TGT_CHAN ) , % VAL( 10$ READVBLK ) , 

^t 1 IOSB,,, DATA ARRAY, %VAU51 2 ),,,,) 

Z?- 8 SYS$0IOW(,%VAL(SRC_CHAN),%VAL(IO$ WRITEVBLK) ,I0SB, , , &^ 

1 DATA_ARRAY,%VAL(512),,7,) ' 

8. SOURCE and/or TARGET may disconnect the link 
SYS$QI0W( ,%VAL<SRC_CHAN) ,%VAL( IO$_DEACCESS) ,I0SB, ,,,,,,,) 






d&> 



a 



<r 
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1.4 How DECnet Identifies Logical Links 

• TARGET and SOURCE will have a different network channel 
number for each logical link they establish 

• DECnet associates the channel number (port) with a unique 
link identifier 

• ECL modules on each side will agree on a pair of link 
addresses to associate with that link 

- A 16-bit numerical address is assigned to each end of 
a logical link 

A given 16-bit address must not be assigned to two 
ports concurrently 

- A given 16-bit address must not be reassigned for a 
long period following its deassignment 

- The port at one end of the link contains the address 
of the port at the other end of the link, and vice 
versa 

- The complete identification of the link is a 32-bit 
number 

• The logical link identifier is used as an index into the 
link table (LTB) to find the associated XWB for the 
logical link 
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NODE A 



<BOB> 



I 

<TED>« 



NODEB 



• <CAROL> 

i 

I 



.<ALICE> 



LOGICAL LINKS BETWEEN 

BOB AND CAROL 

TEDANDALICE 

TED AND CAROL 





LOCAL LINK 
ADDRESS 


REMOTE LINK 
ADDRESS 




>• 


LOCAL LINK 
ADDRESS 
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Figure 6-1 Identifying Logical Links 



6-9 



MAJOR NETWORK MECHANISMS 



1.5 Seeing Logical Link Addresses 

Logical links are accessed by the fields XWB$W_REMLNK 
XWB$W_LOCLNK in the extended window block (XWB) . 



and 



Logical link addresses may also be seen with NCP> SHOW KNOWN LINKS 
command . 



FROM NODE 1.1 

NCP> SHOW KNOWN LINKS 

Known Link Volatile Summary as of 15-APR-1986 23:59:17 



Link 






Node 


PID 


Process 


Remote 
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6159 
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FROM NODE 1.4 



NCP> SHOW KNOWN LINKS 

Known Link Volatile Summary as of 15-APR-1986 23:59:47 













Remote 


Remote 


Link 




Node 


PID 


Process 


Link 


User 


8204 


1.1 


(WOLVES) 


204003B8 


NET 8204 


12323 


FINCH 


8205 


1. 1 


(WOLVES) 


20400539 


NET_8205 


12324 


SWAN 


5134 


1.1 


(WOLVES) 


204003B0 


SprTng 


11301 


FAL 


6159 


1.1 


(WOLVES) 


20400537 


Mai lard 


13350 


PHONE 


4113 


1. 1 


(WOLVES) 


20400117 


REMACP 


12328 


SARA 



Example 6-1 Looking at Logical Links with NCP 



6-10 



MAJOR NETWORK MECHANISMS 



1.6 Cluster Alias Internals 

• Some or all VAXcluster nodes can share a DECnet node 
address 

• Each node can still be accessed by its own address 

• Must have at least one router in the cluster 

• Shared address is ALIAS 

• Each router in the cluster keeps a list of participants 

Cluster link ID table - Alias REGistration Block (AREG) 

4 words per entry: node address - flags and version - 
number of links in use 

(Uses the distributed lock manager to maintain the list) 

• Incoming connection is assigned a cluster-wide link ID by 
the router 

• Participating nodes are selected round robin with a bias 
for ALIAS MAXIMUM LINKS (in multiples of 16) 

• Packet are always forwarded to the receiving node by means 
of the router 

• Outgoing connection is assigned a cluster-wide link ID by 
its own node 
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1,1.7 SCL Tasks in Requesting a Logical Link Connection 

• Identify the destination node address or channel number 
for the ECL by using the node- name mapping table 

• Format connect data for the ECL layer 

• Issue a connect request to the ECL 

• Start the outgoing timer 

1.8 SCL Tasks in Receiving a Logical Link Request 

• Start the incoming timer 

• Parse connect data to obtain source and target end-user 
process names and access control information 

o • Validate any access control information 

j- • Identify and either activate or create the target process 

<r • Map the source node's address to a node name 

£ v I 

4 o- • Deliver the incoming connect request to the end-user 

T | -£J process 

1 A 
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1.9 NSP Functions in Establishing and Disconnecting Logical Links 

A source NSP and a destination NSP exchange messages to establish 
and destroy (in other words, to connect and disconnect) logical 

links. 

Figures 6-2 through 6-6 summarize the message exchanges. 
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Figure 6-2 Connection with Acceptance 
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Figure 6-3 Connection with Rejection 
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Figure 6-4 Connection Attempt with No Resources 
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Figure 6-5 Connection Attempt with No Communication 
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Figure 6-6 Disconnection 
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2 NSP FLOW CONTROL MECHANISMS 

• Control buffer space for temporary message storage 

• Ensure that data is not lost for lack of buffering 
capability and that deadlocks do not occur 

• Both normal and interrupt data are subjected to flow 
control 

• Mechanism used determined at logical link formation 

• There is a choice of: 

1. No flow control 

2. Segment flow control (request count) 

3. Message flow control 

• Choice is indicated by means of fields in connect 
initiate, retransmitted connect initiate, and connect 
confirm messages 

• Each data-transmitting NSP must accept the type of flow 
control the data-receiving NSP expects 

NOTES 

1 . Message flow control is obsolete and will be 
eliminated at a future time. 

2. DECnet-VAX always uses no flow control. It 
supports segment flow control for 
compatibility with other systems that may 
request it (RSX) . 
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2.1 No Flow Control 

If the data- receiving NSP selected no flow control, the 
data-transmitting NSP may transmit data at any time (subject to the 
ON/OFF constraint). 

1. A data transmitting NSP will send as many messages as it 
can put in the pipeline. 

2. When the data receiving NSP cannot accept any more 
messages, it will send a link service data message with a 
DO NOT SEND (XOFF) indicator. 

3. When the value is DO NOT SEND (backpressure), the 
data-transmitting NSP may not transmit normal data. 

4. When the data receiving NSP can receive more packets, it 
will send a SEND (XON) indicator. 



Process A 



Process B 



Link Service Data Request 
(ON - send data) 



Link Service Data Request 
(OFF - do not send data) 
(ACK message 3) 

Link Service Data Request 
(ON - send data) 



Ack segment 5 



— > 
< — 
< — 
<— 

— > 



— > 

< — 
<— 
— > 



Data segment 1 
Data segment 2 
Data segment 3 



Data sement 4 
Data segment 5 



Example 6-2 XON/XOFF Flow Control 
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3 SENDING AND RECEIVING NORMAL AND INTERRUPT DATA 

• NSP uses a basic acknowledgment mechanism to ensure that 
messages are delivered 

• NSP has four types of data messages: 

A. Data segment messages 

B. Interrupt messages 

C. Data request messages 

D. Interrupt request messages 

• Uses same acknowledgment mechanism for each type of data 
message 

• On a logical link, the four data messages can be thought 
of as moving in two subchannels 

• Messages in each subchannel are numbered sequentially by 
the transmitting NSP 

• The transmitting NSP waits up till retransmit time for an 
acknowledgment and then it retransmits the message 

• It is not necessary to acknowledge each message 
individually 
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I The data-transmitting NSP assigns a transmit number to a message, transmits the message, and 
starts a timer. 



DATA-TRANSMITTING 
NSP 




TRANSMIT NUMBER = N 
DATA SEGMENT MESSAGE 




DATA- RECEIVING 
NSP 














TRANSMIT NUMBER = M 
"OTHER DATA" MESSAGE 









DATA SUBCHANNELS 



i If the timer times out, the message is retransmitted. 



I If the timer does not time out, and the flow control mechanism allows another message to be sent, the 
data-transmitting NSP assigns the transmit number plus one to the next data message transmitted in 
that subchannel. 



DATA-TRANSMITING 
NSP 




TRANSMITTING NUMBER = N+1 
DATA SEGMENT MESSAGE 




DATA- RECEIVING 
NSP 












TRANSMIT NUMBER = M+1 
"OTHER DATA" MESSAGE 







DATA SUBCHANNELS 



I When the message with the first transmit number is received by the data-receiving NSP, it returns that 
number as an acknowledgement number within the first acknowledgement. 
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Figure 6-7 NSP Segment Acknowledgement 
(Sheet 1 of 2) 
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If the next data message transmit number received is equal to the current acknowledgment number plus 
one. the data-receiving NSP accepts the data message, incrementing the acknowledgment number. It 
then sends the new receive acknowledgment number back to the data-transmitting NSP within an ack- 
nowledgment message. 




RECEIVE ACK. 
NUMBER = N 
DATA 

ACKNOWLEDGMENT 
MESSAGE* 



RECEIVE ACK. 
NUMBER = N + 1 
DATA 

ACKNOWLEDGMENT 
MESSAGE 



RECEIVE ACK. 
NUMBER = M 
"OTHER DATA" 
ACKNOWLEDGMENT 
MESSAGE 



DATA- 
RECEIVING 
NSP 



DATA SUBCHANNELS 

* The data-receiving NSP might not send an acknowledgment for each data message received. The 
received acknowledgment number implies that all previous numbers were received. 



However, if the data-receiving NSP receives a data message transmit number less than or equal to the 
current receive acknowledgment number for that subchannel, the data segment is descarded. The data- 
receiving NSP sends an acknowledgment back to the data-transmitting NSP. The acknowledgment con- 
tains the receive acknowledgment number. 



If the data-receiving NSP receives a data message transmit number greater than the current receive ack- 
nowledgment number plus one for that subchannel, the data segment may be held until the preceding 
segments are received or it may be discarded. 
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Figure 6-7 



NSP Segment Acknowledgement 
(Sheet 1 of 2) 
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3.1 Pipeline Quota 

• Pipeline quota specifies the maximum number of bytes of 
nonpaged pool that NSP will use for transmission over 
logical links 

• Increase for satellite links (6000 +) 

• Limit is in multiples of packets, set to pipeline 
quota/buffer size 

• Packets also get buffered on the output queues for each 
circuit 

• Each circuit has a set of private receive buffers 

The pipeline factor, n, will be 
pipeline quota 



n = 



buffer size 



- Transmitter can send up to n segments before receiving 
ACK on the first. 



PIPELINE QUOTA 

THE PIPELINE FACTOR, N, WILL BE N- ~-—— — — : 

BUFFER SIZE 



TRANSMITTER CAN SEND UP TO N SEGMENTS 
BEFORE RECEIVING ACK ON THE FIRST. 



PROCESS A PROCESS B 

-* DATA SEGMENT 1 

-« DATA SEGMENT 2 

-« DATA SEGMENT 3 

ACK SEGMENT 3 *- 

-« DATA SEGMENT 4 

■* DATA SEGMENT 5 

-« DATA SEGMENT 6 

ACK SEGMENT 6 *► 

MKV8 7-0598 

Figure 6-8 Operation of Pipeline Quota 
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4 ROUTING UPDATE PROCESS 

• Constructs and sends a segmented routing message to 
adjacent nodes after determining that certain conditions 
are met: 

- A Level 1 Routing Message containing a given set of 
destinations is sent on a circuit when a routing 
configuration change has occurred 

- Level 1 Routing Messages are sent to adjacent routing 
nodes within the node's home area 

- Routing updates are forced after the elapsing of the 
routing timers 

- A Level 2 Routing Message is sent under similar 
circumstances for AREA routing nodes 

- Routing Message is sent to the multicast ID "all 
routers" on Ethernet circuits 

- Sent to adjacent nodes on nonbroadcast circuits 

• Accepts the following as input: 

- The minimum hop vector, MINHOP 

- The minimum cost vector, MINCOST 
The area minimum hop vector, AMINHOP 
The area minimum cost vector, AMINCOST 

- The Send Routing Message flags, SRM 

- The Area Send Routing Message flags, ASRM 
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4.1 Processing of Routing Update Message 

1 . Check to see that this is a new message 

2. Store the changed cost/hops info (NODE CHANGES vector) 

3. Re-evaluate the cost/hops for node 

4. Check information for each node in routing message 

- Build the packed cost/hops field by merging hops/cost 
information 

- If the cost or hops to this node exceed our maximums 
(MAXHOPS/MAXCOST) , then declare the node unreachable 
by forcing the cost and hops to infinity (~X7FFF) 

- Record changes so that EVL may be notified 
Determine least cost path to this node 

a. Get the cost/hops for this node over this 
adjacency, and increase it by the hop for ourself 

b. Also compute the new cost for this path 

c. For a broadcast circuit, the cost/hops buffer 
contain? the state of all end-nodes on that 
broadcast circuit 

d. Check to see if this path is "less cost" than the 
previous minimum cost (MH/MC vector) 

e. Use the node address of the adjacent node as a 
tiebreaker 

- If this path is the "least cost", remember it as the 
best 

Send routing message only if min hops/cost has changed 
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7. 
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Example 6-3 Routing and Forwarding Database Tables 
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Example 6-4 Routing UPDATE Exercise 
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5 MESSAGE SEGMENTATION 

5.1 Segmentation and Reassembly of User Messages 

• Buffer size and number of buffers are limited on each node 

• user messages from session control buffers cannot always 
be sent in one piece 

• These messages contain user data as well as NSP header 
information 

• A data-transmitting NSP breaks up data contained in a 
single session control buffer into segments (packets) 

- Transmits the segments by means of Data Segment 
messages 

The maximum length of a data segment is the lesser of: 

1. The size of a transmit buffer in the source node 
(EXEC BUFFER SIZE or LINE BUFFER SIZE) 

2. The maximum length that the data- receiving NSP can 
receive 

( "jH^OttOSii^'K S-J^ZtS^ g LINE BUFFER SIZE) 

• A data- receiving NSP reassembles the segments into the 
correct sequence 

NOTE 

The segment acknowledgment scheme (Section 
3) ensures that all data segments are 
received. 
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Figure 6-9 Model of Data Flow as Seen by Session Control 
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5.1.1 Message Segmentation Steps 

• For a user packet being transmitted, the routine is 
XMIT_COPY in NETDRVNSP 

• Get a free transmit buffer 

• The size of the transmit buffer will be 

XWB$W REMSIZ (maximum transmit segment size 

from the remote node) 
+ NSP$C HSZ_DATA (size of NSP header) 
+ TR3$C~HSZ DATA (size of ROUTING LAYER header) 
+ CXB$C_OVERHEAD (size of CXB header) 

• Get a fixed sized buffer and enter as much of the message 
as possible into it (CXB) 

(Take XWB$W_REMSIZ of the data at a time) 

• Process that segment 

• Repeat for each segment from BOM to EOM 
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TRACING DECnet ACTIONS 



INTRODUCTION 

The DECnet-VAX Source Listings are available on microfiche or 
on-line. This chapter presents hints for reading the source 
listings to analyze a DECnet mechanism, and also traces various 
actions. 

Topics include: 

• Hints On Reading the Source Listings 

• Major Modules of DECnet-VAX 

• Tracing the Creation of a Logical Link 

• Tracing the Sending of Normal Data 

• Other DECnet Actions 

• Selected Routine Listings 
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1 HINTS ON READING THE SOURCE LISTINGS 



I. Preparation 

A. Have a good, general idea of the major components and 
their interaction. 

B. Have sure copies of the map and the listings available 
either on paper or microfiche. 

C. Learn how to use the map and listings effectively: 

Identifying the starting address of the major 
component, if any 

Determining how many modules make up a major 
component 

Identifying which module and which line of code 
defines a global symbol 

II. Pass 1 

A. Treat the listings like a road map. Make sure you 
don' t get lost! 

B. Focus on instructions that will pass control to 
another module or subroutine. Do not try to follow 
every instruction! 

C. Read the comments! 

D. If you have paper listings, you can use a highlight 
pen to trace the major paths. 

E. If you use microfiche, chart out a simple major path 
map. 
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III. Pass 2 

A. Assume an error- free path. 

B. Use the map or highlighted listings to extract some 
interesting information. 

C. Interesting paths to trace through: 

Sending connect initiate 

- Receiving connect initiate 

- Sending connect confirm 

- Sending/receiving normal data 

- Sending/ receiving interrupt data 

- Disconnecting a logical link 

D. After tracing through the different paths, it will be 
clear that a lot of common code is executed. 

E. The different traces can be used to get an overall 
map. 

IV. Pass 3 

A. Relate the data structure to the code. 

B. Put in sufficient comments to get a "tour guide" 
through the listings. 

V. Subsequent Passes Should be Used to Obtain Specific 
Information 
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2 MAJOR MODULES OF DECnet-VAX 



NETACP 

Module Name 

NETACPTRN 

NETPROCRE 

NETTRN 

NETCNF 

NETDLLTRN 

NETCTLALL 

NETEVTLOG 

NETLLICNT 

NETGETLIN 

NETCONFIG 

NETCNFACT 

NETCNFDLL 

NETDLB 

NETTREE 

NETCONECT 

NETOPCOM 

NETCLUSTR 

NETJNXCO 



(Reference: NETACP. MAP) 



Bytes 

4265 
3798 
1171 
3057 

26405 

3736 

1907 

1484 

720 

11556 
6565 
6007 
2218 
3266 
3000 
165 

10992 
433 



Description 

Control network local node state transitions 

Process creation 

Main ACP loop and misc. subroutines 

Configuration database access routines 

Routing and Datalink layer 

Process ACP control QIOs 

Process Event logging needs 

Counter support for nodes and logical links 

Check for DECnet license 

Local configuration database 

Configuration database access action routines 

Datalink database action routines 

NETACP DLE processing 

BINARY TREE processing routines 

Process user connect requests 

Operator communications 

Cluster node name routines 



NETDRIVER 

Module Name 

NETDRVSES 
NETDRVNSP 
NETDRVXPT 
NETDRVQRL 
NETDRVJNX 



(Reference: NETDRIVER. MAP) 



Bytes 

3717 

5532 

4661 

741 

433 



Description 

DECnet session control module for NETDRIVER 
DECnet NSP module for NETDRIVER 
NETDRIVER routing layer 
DECnet Quick Routing Layer module 



NDDRIVER (Reference: NDDRIVER.MAP) 
Module Name Bytes Description 
NDDRIVER 2400 DECnet DLE driver 

The Appendix contains a detailed listing of DECnet-VAX modules, 



7-7 



TRACING DECnet ACTIONS 



3 TRACING THE CREATION OF A LOGICAL LINK 
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Figure 7-1 Envrroraignt of Sending a Connect Initiate 
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USER ISSUES $QIO 



CREATE IRP AND CALL NETDRIVER'SFDTROUTINES 



NETDRIVER'S FDT ROUTINES PASS IRP TO NETACP 



BUILD ICB & REQUEUE IRP(WITH ICB) TO NETDRIVER 



BUILD XWB FOR CI & SET UP RETRANSMIT TIMER 



SOLICIT ROUTING FOR PERMISSION TO TRANSMIT 



RETURN TO NSP TO BUILD CONNECT INITIATE PACKET 



BACK TO ROUTING TO QUEUE PACKET TO DL DRIVER 



RETURN IF $QIO OR WAIT FOR CC IF $QIOW 
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Figure 7-2 Simplified Flow of Sending a Connect Initiate 
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3.1 Overview of Sending a Connect Initiate (CI) 

A. User program issues $QIO 

B. EXE$0IO creates IRP 

C. NETDRIVER FDT routines create complex buffer and pass IRP 
to VMS EXEC ^ Ac3<5AcCe%r\JtV 

D. VMS EXEC sets up ACP buffer and queues it to NETACP '' ^ &W 

E. Overview of NETACP actions 

NETACP reads the user connect info to build an Internal 
Connect Block (ICB) which it attaches to the IRP$LDIAGBUF 
field of the IRP. it then requeues the IRP to the driver. 

The role of NETACP is to look up default access control 
(user name, password, account) information in its database 
and translate node and object names to numbers. 

F. Overview of NETDRIVER actions 

NET$ACCESS reads the ICB and determines the type of 
connect. It builds an XWB for connect initiate events and 
locates an already existing XWB for all others. 
NET$ACCESS stores the appropriate event code in R7 and 
returns expecting the caller (NETDRIVER) to call the event 
dispatcher (NET$EVENT). 

Note that the size of the XWB is not charged against the 
user byte count or byte limit quotas. Logical links are 
charged against the file limit quota of a process. 

G. NET$EVENT dispatches to ACT$INITIATE to set up the 
retransmit timer and switch to the solicit state 

H. Solicit permission from routing to transmit the packet and 
if granted build the CI message 

I. Queue the packet to the UCB of the data link driver by 
means of the internal QIO mechanism 

J. Return to the user ($QIO) or wait for a connect confirm 
($0IOW) 
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3.1.1 Sending a Connect Initiate (CI) 

1. User program, after setting up the Network Connect Block 
(NCB), issues a QIO call with a function of IO$_ACCESS 

$QIOW CHAN=NET_CHAN, 

FUNC=#IO$_ACCESS, - 

IOSB=IOSB, 

P2=NCB_DESC 

NCB: .ASCII /CANADA: : "TASK=NONTRTGT. EXE"/ 

NCB_DESC: 

.LONG .-NCB 
.ADDRESS NCB 



2. EXE$QIO 

Executed by means of the change mode dispatcher 
(CMODSSDSP) in the VMS EXEC 

- Forms IRP to be passed to NETDRIVER such that: 

IRP$B TYPE - DYN$C_IRP 

IRP$L_PID = user process ID 

IRP$L_UCB - NETDRIVER 

IRP$W_FUNC ■ IO$_ACCESS 

IRP$W_CHAN = channel index 

IRP$W_STS = init to zero 

IRP$L_SVAPTE = NCB_DESC 

- Enters the Function Dispatcher Routines (FDT routines) 
in NETDRIVER 

- For connect initiate, goes to NET$FDT ACCESS 
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3. NET$FDT_ACCESS - NETDRIVER (NETDRVSES) 

- Packages the user parameters into a "complex buffer" 

- The IRP is passed by means of the executive to NETACP 
at NETTRN 

- Passes it by means of an ACP Queue Block Mechanism 
(AQB) 

- Jumps to ACP$ACCESSNET 

4. ACP$ACCESSNET - VMS EXEC (SYSACPFDT) 

- Access (connect) to network function processing 
Build ACP buffer 

- Queue it to ACP 

- Wake up NETACP - enter NET$DISPATCH in NETTRN module 

5. NET$ DISPATCH - NETACP (NETTRN) 

- Major NETACP work dispatching loop 

NETACP has three queues to handle ( in order) : 

A. Timer queue - Timer ASTs 

B. Work queue - requests from NETDRIVER 

C. AQB queue - requests from user program 

If there is a request in one of its three queues, 
NETACP dispatches to one of its processing routines 

When the queues are empty, NETACP hibernates 

For connect initiate, the request is in the AQB 

- Dispatch to NETCONECT (for CI) 
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6. NETCONECT - Network ACP 

- This module performs processing for logical link 
connect requests including connect initiate, connect 
confirm, and connect reject 

- Parse the Network Connect Block (NCB) 

- Build an Internal Connect Block (ICB) containing the 
parse and hang it onto the IRP 

NCBs have the same form as the translation of the 
logical name "SYS$NET" 

node" access control info": :"taskname/linknumber+userdata* 



' node ' 
'object' 
' taskname' 



may be specified either by name or number, 
may be specified either by name or number, 
legal taskname formats are: 



"objectname= 
"objectnumber* 
"TASK= taskname 
"0= taskname 

- Obtain the default access control information (user 
name, password, account) and set up the proxy login 
state for this OBI (Object) 

- Set up the Remote User ID (RID) for display purposes 
Translate the node name to node address 

- Check for access restrictions set for the remote node 

See if the connect is allowed based on local node 
state 



STATE 

ON 
RESTRICT 

SHUT 
OFF 



Allow Connect If 

Always 

If this is a connect initiate, or 

if the partner node is the local node 

Never 

Never 
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- See if the remote node is reachable 
Check the ADJ and LPD for that node 

- If node is adjacent, try to increase theJ>u£fer size 




- Requeue the IRP to the NETDRIVER 
(IRP$L_DIAGBLF field points to the ICB) 

- Return to NET$ DISPATCH 

7. NET$DISPATCH - NETACP (NETTRN) 

- Finish IRP processing 

- Jump to EXE$INSIOQ 

8. EXE$INSIOQ - VMS EXEC (SYSQIOREQ) 

- If NETDRIVER is busy, call EXE$INSERTIRP to QUEUE the 
IRP 

- If NETDRIVER is idle, call IOC$ INITIATE to process the 

IRP ^ \W W-a^\d> 

9. IOC$INITIATE - VMS EXEC (IOSUBNPAG) 

- Put the IRP address and user parameters into the UCB 

- Clear the device status bits 

- Jump to NET$STARTIO ( NETDRIVER' s start I/O entry 
point) 
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10. NET$STARTIO - NETDRIVER (NETDRVSES) 

Start the I/O operation 

- Extract function code from IRP 

- Dispatch to NET$ACCESS 

11. NET$ ACCESS - NETDRIVER (NETDRVSES) 

- Read the ICB and determine the type of connect 
Set up outbound connect timer (outgoing timer) 
Put the event code in R7 

- Return to NET$STARTIO, which calls the event 
dispatcher (NET$EVENT) 









\c"X 



-fcC^-FT" 
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12. NET$ EVENT - NETDRIVER (NETDRVSES) 

- State table event dispatcher used to determine what is 
to be done and what state the XWB is to enter next 



- Inputs: 

R7 
R6 
R5 
R3 

- Output: 

RO 



Code of event to process 
The UCB address 
Address of XWB 
QIO IRP address 



Status code from the action routine to be 
returned to the caller of the event dispatcher 



- Dispatch to ACT$INITIATE based on the event code 
On return, change logical link state 

- Actions dispatched by ACT__DISPATCH of NET$EVENT 
Routine Called Description 



ACT$ ABORT 

ACT$BUG 

ACT$CANLNK 

ACT$CONFIRM 

ACT$DEACCESS 

ACT$ENT_RUN 

ACT$ INITIATE 

ACT$LOG 

ACT$NOP 

ACT$RES_DISC 

ACT$RCV_CA 

ACT$RCV_CC 

ACT$RCV_CI 

ACT$RCV_CR 

ACT$RCV_DATA 

ACT$RCV_DTACK 

ACT$RCV_DX 

ACT$RCV_LI 

ACT$RCV_LIACK 

ACT$RCV_RTS 

ACT$RTS_NLT 

ACT$SHRLNK 

ACT$SSABORT 



Abort logical link 

Bugcheck action routine 

Cancel logical link 

Process connect confirm 

Process IO$__DEACCESS 

Enter RUN state 

Process connect initiate 

Log-event action routine 

Do nothing 

Resume disconnect processing 

Respond to Connect Acknowledge 

Respond to a received connect confirm 

Process a received connect initiate 

Process a retransmitted connect initiate 

Process a received data message 

Process a received data ACK 

Process a received DI or DC message 

Process a received INT/LS message 

Process a received INT/LI ACK 

Receive CI being 'returned to sender' 

Return to sender as 'no link terminate' 

Abort the QIO 

Abort the QIO (link was disconnected) 
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13. ACT$ INITIATE - NETDRIVER (NETDRVSES) 

- Connect initiate action routine 

- Get ICB from IRP and attach it to XWB 

- Move remaining parameters from the ICB into XWB fields 

- Set up timer and delay so that the connect message 
will retransmit periodically if necessary 

Delay * Delay Factor 

Retransmit Time = 

16 

MSG Delay + Old Delay * Delay Weight 

Delay = 

(1 + Delay Weight) 

- Return to NET$ EVENT 

14. NET$ EVENT - NETDRIVER (NETDRVSES) 

- Switches to next state (solicit) 

- Solicits permission from NSP to send connect request 

- Execute NET$SCH_MSG 

15. NET$SCH_MSG - NETDRIVER (NETDRVSES) 

- Schedule message transmission by means of NSP$SOLICIT 

16. NSP$SOLICIT - NETDRIVER (NETDRVNSP) 

- Solicit permission to transmit from routing 

- Call TR$SOLICIT in routing layer to get an IRP and a 
buffer to send the connect request to the remote node 
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,«P 



^ .9 



17. TR$SOLICIT - NETDRIVER (NETDRVXPT) 

- Process ECL request to transmit into the network 

- Find the appropriate logical path (LPD) 

- Check availability of the transmission resources 

- If okay, grant permission to transmit (TR$GRANT) 
Else, enter the request block onto a wait queue 

18. TR$GRANT - NETDRIVER (NETDRVXPT) 

- Set up the routing fields of the Complex Buffer (CXB) 

- Reactivate solicitor (NSP$SOLICIT @QUICK_SOL) granting 
permission to transmit 

On return, the CXB and registers are set up as follows: 



Standard 
VMS 
Buffer Header 



ECL 
Pure Area 



Datalink 

Layer 

Impure Area 

Body of 
Message 

Datalink 

Layer 

Impure Area 



11 bytes long. CXB$L_FLINK and CXB$L_BLINK may 
be used by the transport layer. CXB$W_SIZE 
must be correct. CXB$B_TYPE must be DYN$C_CXB. 

Starts with CXB$B_CODE (byte 11) and continues 
to CXB$C_LENGTH. This area is read-only to 
transport and below. It cannot even be 
saved/ restored . 

Starts at CXB$C_LENGTH and is at least 
CXB$C_DLL bytes long. Used by the datalink for 
protocol header or state information. 

Must be quadword-aligned and starting no sooner 
than CXB$C_LENGTH + CXB$C_DLL (= CXB$C_HEADER) . 

Used by the datalink layer for protocol (e.g., 
checksum) or state information. Must be at 
least CXB$C_TRAILER in length. 



f7xTf^\^^\ 






^ 
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R9 AD J address 
R8 LPD address 

R3 IRP address — unmodified from call 
RO Low bit set - if message is to be transmitted 
Low bit clear - if no message to transmit 

19. NSP$SOLICIT - NETDRIVER (NETDRVNSP @ QUICK_SOL) 

- Build the Connect Initiate (CI) message (BLD_DISPATCH) 

- Set up the routing header info 

- Update information in the Node Counter Block (NDC) 

- Return to the routing layer to send the message 
(TR$SOLICIT) 

20. TR$SOLICIT - NETDRIVER (NETDRVXPT @ QUICK_SOL) 

- Make sure NETACP is still active 

- Return to TR$GRANT (NETDRVXPT) which branches to 
FINISH_XMT_HDR 

21. FINISH XMTHDR - NETDRIVER (NETDRVXPT) 

Build a routing header based on the output path 

- Finish building the IRP and queue it to the UCB of the 
data link driver (EXE$ALTQUEPKT) 

- If for the local node, use TR$ LOC_DLLXMT - NETDRIVER 
(NETDRVXPT) 

22. EXE$ALTQUEPKT - VMS EXEC (SYSQIOREQ) 

- Activate the driver at its ALTSTART entry point using 
the internal QIO mechanism 

- The packet will now be sent out over the circuit and 
control will return to NET$STARTIO 
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23. NET$STARTIO - NETDRIVER (NETDRVSES) 

- Exits with the IRP still queued to the UCB 

- Waits for either a connect confirm or disconnect 

- Returns to EXE$QIO 

24. EXE$QIO - VMS EXEC 

- If $010, returns to the user indicating that the $QI0 
has been processed - the IOSB not filled in 

If $QI0W, waits for connect confirm or disconnect 
before returning to the user with the IOSB filled in 

- User does not have a logical link until the connect 
confirm is generated and processed 
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Figure 7-3 Environment of Receiving a Connect Initiate 
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DATA LINK DRIVER RECEIVES AND VALIDATES PACKET | 



INTERNAL QIO GIVES IRP TO NETDRI VER'S ROUTING "1 



COMMON RECEIVE ROUTINE CHECKS MESSAGE TYPE 
DISPATCHES TO NETDRIVER'S NSP ROUTINES 



CREATE XWB AND DISPATCH TO NETDRIVER'S SCL 



| SEND BACK CA MESSAGE & WRITE TO NETACP'S MBX I 



I CHECK NCB& CREATE/LOCATE APPROPRIATE PROCESS | 



WAIT FOR IMAGE TO SENDiBACKlCONNECT CONFIRM 
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Figure 7-4 simplified Flow of Receiving a Connect Initiate 
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3.2 Overview of Receiving a Connect Initiate 

A. Data link drivers perform the necessary data link checking 

B. The data is passed to the routing layer (NETDRVXPT) 

C. The message type and the routing header are checked 

D. If the message is for the local node, control is passed to 
ECL and the destination logical link address is examined 

E. session control sends back a connect acknowledge message 
and calls NETACP by means of a mailbox write 

F. NETACP gets the process information from the NCB 

6. NETDRIVER is informed that the process has been created 
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3.2.1 Receiving a Connect Initiate 

1. The datalink device driver (XEDRIVER, XMDRIVER, etc.) 
receives and validates a data message. 

- Jumps to COM$POST to perform the standard VAX/VMS I/O 
completion processing 

2. COM$POST - VMS EXEC (COMDRVSUB) 

- Used by the terminal, mailbox, and data link drivers 
to complete I/O operations independent of the status 
of the unit 

- Increment operation count 

- Insert packet on the I/O posting queue (IOC$GL_PSBL) 

- Request a software interrupt for I/O post processing 
(SOFTINT #IPL$_IOPOST) 

3. IOCIOPOST - VMS EXEC ( IOCIOPOST) 

Implements the device- independent completion 
processing for I/O packets 

- Performs all appropriate completion activity required 
for the packet 

Setting event flags, unlocking buffer pages, releasing 
buffers 

- Because the initial request was from an internal QIO, 
the IRP is given to the NETDRIVER at either 
TR$RCV_DIO DATA for direct I/O, or TR$RCV BIO DATA for 
buffered l7o 
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4. TR$RCV_DIO_DATA - NETDRIVER (NETDRVXPT) 
TR$RCV_BIO_DATA - NETDRIVER (NETDRVXPT) 

- Receive direct/buffered I/O from datalink layer 

- The IRP is being returned by the data link driver 
after a receive operation 

- Statistics are taken and the packet is routed to its 
destination 

- Reset byte count quota (for BIO) 

- Detach the CXB from the IRP 

- Requeue the received IRP to the datalink of the same 
device for another receive 

- Process the message by branching to RCV_DIO_BIO 

5. RCV_DIO_BIO - NETACP (NETDRVXPT) 

- Common receive IRP processing 

- Check for success of the read request 

- Process the received message 

- Determine size of message 

- Dispatch on message type by branching to DISP_RCV_MSG 
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6. DISP_RCV_MSG - NETDRIVER (NETDRVXPT) 

- Process the received message by dispatching to the 
appropriate action routine 

- The first byte of the received message should be one 
of the following: 

<0000 1000> Phase II NOP 
<0101 1000> Phase II Start 

<0100 xxlO> Phase II route header 

<000x x010> Phase III route header 

<000x x010> Phase IV nonbroadcast circuit route header 

<00xx OxlO> Phase IV broadcast circuit route header 

<0000 0001> Phase III init 

<0000 0011> Phase III verification 

<0000 0101> Phase III hello message 

<0000 0111> Phase III routing message 

<0000 1001> Phase IV Level 2 routing message 

<0000 1011> Phase IV broadcast circuit router hello 

message 
<0000 1101> Phase IV broadcast circuit endnode hello 

message 

- Find the adjacency using the message source address 

- For Ethernet end nodes, use the designated router 
adjacency 

- For broadcast circuit, first try the OA vector to look 
for a match in the ADJ database 

- If no match, assume this message came from a broadcast 
router and scan the BRA portion of the ADJ vector 

- Otherwise, scan the entire ADJ database for the node 

- For nonbroadcast circuit, use ADJ index in the LPD 
Save the source ADJ index in the CXB 

- Parse the message and dispatch to TR_RTHDR (CI message 
has a phase IV routing header) 
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7. TR_RTHDR - NETDRIVER (NETDRVXPT) 

Process received message's route header 

- Check type of route header (phase and broadcast, or 
not) and process it 

For a broadcast end node, update the endnode cache 

- Fall through to TR_ECL 

8. TR_ECL - NETACP (NETDRVXPT) 

- Update ARRIVING PKTS RCVD and PMS (monitor) database 

Set up the packet and call the ECL layer with: 

R7 Size of ECL message 

R6 Received CXB address 

R2 RCB address 

Rl Points to first byte in ECL message 

CXB$L_R_RCB RCB address (copy of R2) 
CXB$L_R_MSG Points to ECL message (copy of Rl) 
CXB$W_R_BCNT Size of ECL message (copy of R7) 
CXB$W_R_SRCNOD Source node address 
CXB$W_R_DSTNOD Destination node (the ECL) address 
CXB$B_R_FLO Low bit clear if CXB can be consumed 

Low bit set if CXB must be returned 
Second bit clear if no return-to- 
sender packet 

Second bit set if packet returned-to- 
sender 
CXB$W_R_PATH I.D. of receiving LPD 

- Branch to NET$UNSOL INTR 
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9. NET$UNSOL_INTR - NETDRIVER (NETDRVNSP) 

- This "unsolicited interrupt" routine is called by 
routing whenever it has received a message addressed 
to NSP 

- NSP must process the message completely and return to 
transport 

- The message can be found in a single buffer of 
"complex chained" (CXB) format 

- If NSP wishes to keep the message, it must zero the 
CXB pointer before returning to transport 

- Map the message into an event code and check for 
message size violations 

- For #NSP$C_MSG_CI (CONNECT INITIATE) 

Check to see if this is a message being returned 
because the remote node is unreachable 

For an incoming connect request - create an XWB 

Get source and remote node addresses for 
subroutine calls 

Check for reachability 

Get UCB address 

Get a new XWB and link slot 

Increment "connects received" 

Store the path over which the message was received 
in XWB$W_CI_PATH 

Start inbound timer since we will break the link 
if we time out before user issues the IO$_ACCESS 
function 

Store remote link address 

- Branch to NET$ EVENT to process the message 
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10. NET$ EVENT - NETDRIVER (NETDRVNSP) 

- State table event dispatcher used to determine what is 
to be done and what state the XWB is to enter next 

- Dispatch to ACT$RCV_CI 

11. ACT$RCV_CI - NETDRIVER (NETDRVNSP) 

- Parse the link characteristics 
Parse the remainder of the message 

- Queue the XWB to NETACP by branching to NET$QUE_XWB 

12. NET$QUE_XWB - NETDRIVER (NETDRVSES) 

- If the XWB is busy, then return 

- If not busy, then set the XWB$V_STS_SOL bit to lock it 

- Queue the XWB to the NETACP' s AQB 

- Jump to SCH$WAKE to wake up NETACP 

13. SCH$WAKE - VMS EXEC (RSE) 

- Wake up NETACP at NET$DISPATCH in NETTRN 
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14. NET$DISPATCH - NETACP (NETTRN) 

- NETACP' s major work dispatching loop 

- Dispatch from AQB element to NET$PROC_XWB 

15. NET$PROC_XWB - NETACP (NETPROCRE) 

- NETDRIVER has passed us an XWB either to be linked 
into the LTB and assigned a local logical link 
address, or to be unhooked from the LTB and 
deallocated 

- If both the XWB$W_REMLNK and XWB$W_LOCLNK fields are 
zero, then this request comes from the NETACP code 
that handles the IO$_ACCESS request for CIs 

- NETACP is responsible for the LTB maintenance and the 
XWB linkage 

- When the LTB slot and its place in the XWB list have 
been found, link XWB into the LTB and set up a local 
link number 

- Create logical link and insert it into database 

- Branch to NET$DELIVER_CI 

16. NET$DELIVER_CI - NETACP (NETPROCRE) 

- Determine whether the connect is to be handed to a 
task that has a declared name or an object type 

Initialize descriptors for process creation 

- Get scratch buffer from NPP 

- Branch to BUILD NCB 
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17. BUILD_NCB - NETACP (NETPROCRE) 

- Build the NCB string for the connect 

- NCB will be passed later to destination process (in a 
number of different ways) 

- Get info from XWB 

- Return to NET$DELIVER_CI which branches to GET_PROC 

18. GET_PROC - NETACP (NETPROCRE) 

- Find the OBI block for the local object 

If the OBI is for a declared name or object then pass 
the NCB to the declaring process's mailbox 

- Otherwise, get ready to create a process 

- Look for an available server process to receive the 
connect 

If there's a matching server process, then send the 
connect to the process 

- Otherwise , create the process 



$CREPRC__S 

INPUT** NET_Q_PROC , 
OUTPUT- NET_Q_ACC, 
ERROR- NET_G_NCB, 
PRCNAM- NET_Q_PRC, 
IMAGE= NET_Q_IMAGE , 
PIDADR= NET_L_PID, 
BASPRI= G~SYS$GB_DEFPRI ,- 
UIC= #<~01@16+~03>, - 
STSFLG- #<STS_M_NETLOG>,- 
MBXUNT= MBX UNIT 



Create the user process 

Network NETSERVER.COM filename 

Access control strings 

First NCB (solely for LOGIN proxy) 

Process name 

Image (LOGINOUT) to run first 

Place to store process id 

Priority 

UIC is [1,3] 

This is a network process 

MBX for termination notification 



- Return to NET$DELIVER CI which branches to TELL_DRV 
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19. TELLJDRV - NETACP (NETPROCRE) 

- Branches to CALL_NETDRIVER 

20. CALL_NETDRIVER - NETACP (NETACPTRN) 

- Jump to NET$ACP_COMM in NETDRIVER 

21. NET$ACP_COMM - NETDRIVER (NETDRVSES) 

Informs NETDRIVER of a change of status based on the 
function codes: 

NETUPD$_CONNECT - Pass NCB to Declared Name mailbox 

NETUPD$_PROCRE - Process created to received connect 

NETUPD$_ABORT - Process couldn't start 

NETUPD$_EXIT - Started process is exiting 

NETUPD$_DLL_ON - Datalink has come online - post a receive 

NETUPD$_DLL_DLE - Datalink online for service facts 

NETUPD$_REACT_RCV - Reactivate datalink receiver 

NETUPD$__SEND__HELLO - Force datalink to send a hello message 

NETUPD$_CRELNK - Create a logical link control structure 
NETUPD$_DSCLNK - Graceful disconnect of single link 
NETUPD$_ABOLNK - Force immediate disconnect of all links 

NETUPD$_BRDCST - Broadcast mailbox message 
NETUPD$_REPLY - Reply to associated mailbox 

Inform NETDRIVER of process created to receive connect 
and return 

22. On return we have to wait for the requested task to issue 
a connect accept or connect reject 

Another possibility is an incoming timer timeout if the 
requested task does not respond 



7-32 



TRACING DEC net ACTIONS 



USER ISSUES $0.10 



CREATE IRP AND CALL NETDRIVERS FDT ROUTINES 



PUT USER MESSAGE INTO COMPLEX BUFFERS (CXB) 



QUEUE CXB TO DATA LOGICAL LINK SUBCHANNEL<LSB) 



SEND THE IRP BACK FOR EARLY 10 COMPLETION 



REQUEST PERMISSION TO TRANSMIT ON LOGICAL LINK 



' ' 


| SEGMENT THE MESSAGE AND BUILD THE PACKET(S) 


■ 


■ 


BACK TO ROUTING TO QUEUE THE PACKET TO DL DRIVER 


' 


< 


[ RETURN IF $QIO OR WAIT FOR ACK IF $QIOW 



MKV87-0604 

Figure 7-5 Simplified Transmission Flow of Normal Data 
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3.3 Overview of Transmission of Normal Data 

A. User program issues $QIO 

B. $010 calls NETDRIVER which dispatches to transmit routines 

C. The user message is segmented into CXBs (complex buffers) 

D. The CXB buffers are queued to the data LSB (logical link 
subchannel) 

E. Request permission to transmit on the logical link - put 
as many messages as possible in the pipeline 

F. Check with routing for permission to transmit 

G. Transmit at the appropriate time 
H. Return success to the user 
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3.3.1 Transmission of Normal Data 

• User program issues $QIO 

SYS$QIOW( , %VAL(NET_CHAN) ,%VAL( IO$_WRITEVBLK) ,IOSB, , , 
1 DATA_ARRAY , % VAL ( DATA_S I Z E ) , , , , ) 

EXE$QIO forms IRP and enters the FDT routines in 
NETDRIVER 

- Dispatches to NET$_FDT_XMT 

• NET$_FDT_XMT - NETDRIVER (NETDRVNSP) 

Inputs: 

AP Pointer to the QIO Pi parameter 

R8 Must be saved/restored on return to next FDT routine 

R7 I/O function code without modifiers 

R6 CCB address 

R5 UCB address 

R4 PCB address 

R3 IRP address 

Switch to XWB context 

- Get data LSB 

Segment th* data message into CXB buffers 

- Jump to XMT_COPY 

- On return the CXB buffers are queued to the data LSB 

- These CXBS are to be passed to the routing layer for 
transmission at the appropriate time 
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XMT_COPY - NETDRIVER (NETDRVNSP) 

- Get a free CXB and enter message type code into the 
CXB 

- Segment the message - XWB$W_REMSIZ bytes at a time 

- Process that segment and each segment from BOM to EOM 
flags 

- Update user virtual address descriptor in IRP and copy 
data into CXB 

- Set up NSP info (SEG #, ACK #) 

- Attach CXB to CXB queue and GOTO XMT_REQ_DONE_OK 
XMT_REQ_DONE_0K - NETDRIVER (NETDRVNSP) 

- Remove IRP from LSB$L_X_PND (pending LSB) 

- Make sure we can transmit the packet 
Try to maximize the transmit pipeline 

- Post I/O by means of COM$POST and signal early I/O 
completion 

- Return to XMIT_RCV_CO which branches to NET$SCH_MSG 

Schedule message for transmission by means of NSP$SOLICIT 
which calls the routing layer of NETDRIVER 



NOTE 

The remainder of the path is the same back to 
EXE$QIO as in sending a CI. 
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4 OTHER DECnet MECHANISMS 
4.1 Transmission of Interrupt Data 

A. Standard VAX/VMS QIO interface 

Logical link has been established. All DECnet data 
structures are present 

B. If NETDRIVER is busy, the IRP is queued to NETDRIVER AND 
control is returned 

C. If NETDRIVER is not busy, the routine IOC$INITIATE in 
IOSUBNPAG Starts the NETDRIVER 

D. Queue the IRP in the Logical Subchannel Block (LSB) for 
interrupt messages 

Only one interrupt message is allowed per logical link 

E. The appropriate Logical Path Descriptor (LPD) is found 

F. An internal IRP is queued to the data link driver and the 
message is transmitted 
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4.2 Reception of Normal Data 

A. Standard VAX/VMS QIO interface 

Logical link has been established. All DECnet data 
structures are present 

B. The FDT routines set the type of buffer to use as complex 
chained buffers (CXBs). 

Control is passed to the main code of NETDRIVER routing 
layer 

C. If data is received, it will be copied from the CXBS into 
the user area 

D. If no data is received, a link service message (to update 
flow control count) will be sent 

E. The flow is very much like the transmission of normal data 
except that in this case link service is sent 

4.3 Reception of Interrupt Data 

A. The data link driver posts outstanding receives using an 
internal IRP with a routine in NETDRVXPT (TR$RCV_DATA) 

Logical link has been established. All DECnet data 
structures are present 

B. The message is for the local node and is an interrupt 
message 

C. The message is written to the user's mailbox 

D. The user reads the mailbox message (write attention ast or 
synchronous mailbox read) 
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4.4 Sending a Disconnect Initiate 

A. Standard VAX/VMS QIO interface 

B. The function code is: 

10$ DEACCESS!IO$M SYNCH OR 10$ DEACCESS ! IO$M ABORT 



C. Control is passed to NETACP, which requeues packet back to 
the data link driver 



D. NETDRIVER is called at its start 10 entry point 



E. The reason for the disconnect and the optional disconnect, 
data is copied to the XWB 



F. The XWB would be queued to the routing module 

The admission policy of routing determines whether the 
message can be sent out 



G. Internal IRP is queued to the data link driver to get the 
message out 
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4.5 Receiving a Disconnect Initiate 

A. Data link driver always posts outstanding receives using 
an internal IRP with a routine in NETDRVXPT ( TR$RCV_DATA) 

B. A special IRP is used to associate the message buffer 
containing the disconnect initiate message 

C. The user is notified by means of MSG$_DISCON message 
written to the mailbox 

D. A disconnect confirm is sent back to the source node 

The data structures associated with the logical link will 
be deallocated 

4.6 Receiving a Disconnect Confirm 

A. A process similar to receiving a disconnect initiate 
happens when receiving a disconnect confirm 
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4.7 Processing ACP Control Functions 

A. Standard QIO interface 

B. NETDRIVER FDT routines pass control to NETACP 

C. NETCTLALL deals with most of the control functions 

D. Some are requeued to NETDRIVER (turning lines off/on) 



E. Dispatch on NFB function 

<NFB$C_LOGEVENT, NET$LOG_EVENT> ,- 
<NFB$C_READEVENT, NET$READ_EVENT> ,- 

<NFB$C_DECLNAME, DCL_NAME> ,- 
<NFB$C_DECLOBJ, DCL_OBJECT> ,- 
< NFB$ C_DECLSERV , DCL_SERVER> , - 

<NFB$C_FC_SET, CTL_DATABASE> ,- 

<NFB$C_FC_CLEAR, CTL_DATABASE> ,- 

<NFB$C_FC_SHOW, CTL_DATABASE> ,- 

<NFB$C_FC_DELETE , CTL_DATABASE> ,- 

<NFB$C FC ZERCOU, CTL DATABASE>,- 
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PERFORMANCE CONSIDERATIONS 



NETWORK DESIGN AND PERFORMANCE CONSIDERATIONS 



INTRODUCTION 

The network manager must understand which factors influence the 
performance of the network and the relationship between these 
factors. 

This chapter discusses some of the basic network design and 
performance considerations. 

Topics include: 

• Buffers 

• DECnet Transfer Process 

• NETACP 

• Routing Considerations 

• Timers 

• VMS Nonpaged Pool Parameters 

• Other Performance Considerations 
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1 BUFFERS 

• Allocated from pool 

• Faster lines perform better with larger buffers 

• Error-prone lines (asynchronous) do better with smaller 
buffers 

• Buffer size passed in logical link request 

• Receive buffers 

- Default buffer size set for executor 

NCP> DEFINE EXECUTOR BUFFER SIZE 576 

- May override executor buffer size for a line 
NCP> DEFINE LINE UNA-0 LINE BUFFER SIZE 1498 

• Make the executor buffer size the same for all routing 
nodes in the network 

• Transmit buffers 

- Transmit - originating 

- Transit - route through 

- NCP> DEFINE EXECUTOR SEGMENT BUFFER SIZE 576 

• 1 <* SEGMENT BUFFER SIZE <» EXEC BUFFER SIZE <» 65535 
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Figure 8-1 Routing Problem with Varying Buffer Sizes 
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1.1 Meaning for Maximum Buffers 

• In Phase III the parameter EXECUTOR MAXIMUM BUFFERS caused 
the pre-allocation of those buffers. This resulted in 
waste if the number was too large or congestion loss if 
the number was too small. 

• Now, the transmit buffer pool floats to its optimal level 
based on usage, up to a limit of MAXIMUM BUFFERS. 

NCP> SET EXECUTOR MAXIMUM BUFFERS n 

NCP> SHOW EXECUTOR CHARACTERISITCS 

• * • • 

Maximum buffers = 15 

Buffer size = 576 



• • • • 



• Each second, the pool is reduced by one buffer, as long as 
a minimum of 10 buffers is present. 

• When all buffers in the pool are in use, and a new buffer 
is needed, one is allocated. 

• There is always one buffer guaranteed to be available for 
each circuit. 

• The new default value of MAXIMUM BUFFERS is 100, which 
simply limits the total pool that can be allocated by 
DECnet. There is no need to specify this parameter in 
normal cases. 

• This new mechanism greatly reduces nonpaged pool 
consumption while the network is running. 
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2 SYSTEM AND USER BUFFERING LEVELS 

Two types of buffers are considered: system and user. 

System buffers are used by the operating system and communication 
software to interface to the communication device(s). 

User buffers are allocated by the application program to hold data 
to interface to the operating system and communication software. 

In general: 

• Have the same system buffer size across the network, or at 
least on the routing nodes 

• An average user buffer size should correspond to the 
system buffer size, considering the protocol's overhead in 
the system buffer 

• The smaller the average message size, the lower the 
potential throughput 

• The greater the variation in message size, the more 
degraded the performance 
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3 DECnet TRANSFER PROCESS 

1. User issues a $QIO or $QIOW to transmit data 

2. Packets are buffered by the system in nonpaged pool before 

the QIO completes 

3. $010 completes as soon as the packet is delivered to the 
local DECnet 

4. The IOSB gets filled in, event flags set, and ASTs queued 
as soon as the packet is delivered to the remote DECnet 

NOTES 

1. By design, everything that happens at the 
network level is supposed to be transparent 
to the user. This process can and does change 
without warning. 

2. The amount of buffering that can happen within 
any logical link is related to the pipeline 
quota (see Section 3.1). 
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4 AFFECTING NETACP 

NETACP is created and run in SYS$MANAGER: LOADNET.COM. It is 
designed for normal network activity. For large networks, you may 
want to give NETACP a larger working set and page file quotas. 

Define the following logical names : 

NETACP$ EXTENT : WSEXTENT 

NETACP$MAXIMUM_WORKING_SET : WSQUOTA 

NETACP$PAGE_FILE : PAGEFILE QUOTA 

$ IF PI .EQS. "" THEN PI - "SYS$SYSTEM:NETACP" 

$ ! 

$ ! Check for user-supplied defaults. 

$ ! 

$ MAX_W0RK = F$L0GICAL("NETACP$MAXIMUM_WORKING_SET") 

$ IF MAX_W0RK .EQS. "" THEN MAX_W0RK ■ "350" 

$ PAGE_FILE = F$LOGICAL("NETACP$PAGE_FILE") 

$ IF PAGE_FILE .EQS. "" THEN PAGE_FILE - "8192" 

$ EXTENT ■ F$LOGICAL("NETACP$EXTENT") 

$ IF EXTENT .EQS. "" THEN EXTENT = "1500" 

$ RUN 'PI' - 

/NOACCOUNTING- 

/NOAUTHORIZE- 

/AST_LIMIT=100- 

/BUFFER_LIMIT=65535- 

/EXTENT=' EXTENT' - 

/FILE_LIMIT=10- 

/I0_BUFFERED=32767- 

/I0_DIRECT=32767- 

/QUEUE_LIMIT=16- 

/MAXIMUM_WORKING_SET= ' MAX_WORK' - 

/PAGE_FILE=' PAGE_FILE' - 

/PRIORITY=8- 

/PRIVILEGES=CMKRNL- 

/PROCESS_NAME=NETACP- 

/UIC=[1,3] 

Example 8-1 Startup of NETACP from LOADNET.COM 



8-10 



NETWORK DESIGN AND PERFORMANCE CONSIDERATIONS 

5 ROUTING PARAMETERS 

• Maximum Hops 

- 1 <= MAX HOPS <= 30 

- MAX HOPS <= MAX VISITS 

• Maximum Cost 

- 1 <= MAXIMUM COST <= 1022 

• Maximum Visits 

- 1 < = MAX VISITS <= 63 

- MAX HOPS <= MAX VISITS O 2 TO 3 * MAX HOPS 

• Maximum Address 

- 1 < = MAX ADDRESS<= 1023 

5.1 Area Routing Parameters 

• Area maximum cost 

• Area maximum hops 

• Maximum area 

5.2 Ethernet Routing Parameters 

• Maximum routers 

• Maximum broadcast nonrouters 

• Maximum broadcast routers 

• Router priority 

(0 to 127 default = 64) 
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6 LIMITING LOGICAL LINKS 

6.1 Maximum Links 

• Specifies maximum logical links count for the local node 

• Includes inbound and outbound connections 

• Limits DECnet activity where this node is the source or 
destination 

6.2 Alias Maximum Links 

• Specifies maximum logical links count for the local node 
that can use the alias node identifier 

• Used to balance the load for inbound alias connects 
(multiples of 16) 

7 SYSGEN PARAMETERS RELATING TO NONPAGED POOL 

• NPAGEDYN/NPAGEVIR 

• SRPSIZE 

• SRPCOUNT/SRPCOUNTV 

• IRPCOUNT/IRPCOUNTV 

• LRPSIZE 

• LRPCOUNT/LRPCOUNTV 
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8 PERFORMANCE OF RMS FAL 

• DAP buffer size increased to 4156 from 544 in VMS V4 

• Maximum record size is 4156 

• Very significant performance improvement over previous 
versions, especially for applications that do a lot of 
file GETS and PUTS 

• VMS SYSGEN parameter RMS_DFNBC 

FAL sends RMS_DFNBC blocks at a time 

Default network transfer block count - determines the 
default message size in disk blocks to be used when 
performing DECnet file transfer operations 

SYSGEN> SHOW RMS_DFNBC 

Parameter Name Current Default Minimum Maximum Unit Dynamic 

RMS_DFNBC 8 8 1 127 Blocks D 

„. u . . ^^^^ 

Adjust this to your DECnet file applications ,, 
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PROTOCOL LAB EXERCISES 

1. Examine and interpret the following protocol message that came 
over the Ethernet. 

SUPER is node 2.230 and HARDY is node 2.149 

PACKET COME IN FROM RIGHT-TO-LEFT TOP-TO-BOTTOM 



001C0360 08950004 00AA08E6 000400AA 

95000400 AA000008 E6000400 AA000026 

00000000 82D10817 64160400 00000008 

44B89B C0000000 00000000 00000000 



PARTIAL BREAKDOWN 



0360 0895000400AA 08E6000400AA 

0400AA00 00082600 0400AA00 0026001C 

000082D1 08176416 04000000 00089500 

00 00000000 00000000 00000000 

44B89BC0 
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PROTOCOL LAB EXERCISES 

2. Interpret the following message received on a DDCMP circuit. 

(READ FROM LEFT TO RIGHT) 

A. RECEIVED MESSAGE: 

0506C000 00017597 

B. RECEIVED MESSAGE: 

810DC005 0601DDB1 
020204050401 
04 010B 0108 
0180 86D3 

C. RECEIVED MESSAGE: 

8122C006 0801FC17 
020204050401 
60 010B 0108 0100 

'HELLO, THIS IS A TEST' (ASCII CODE) 
0612 
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PROTOCOL LAB EXERCISES 

3. Protocol is: 

a. The DNA interface between adjacent layers at the same node 

b. A special message sent over the network to control data 
transmission 

c. The DNA interface between the same layers in different 

. nodes 

4. What type of delivery service does the Ethernet Data Link 
offer to its clients? 

a. Positive acknowlegement with automatic retransmissions 

b. worst-Case control with automatic retransmissions 

c. Best-Effort with indefinite automatic retransmissions if 
collisions are detected 

d. Best-Effort with no more than 16 automatic retransmissions 
if collisions are detected 

5. Etherent data messages can send between and 

bytes of client data. 

6. For the following Segmented Routing Message: 

(Bytes come in right- to-left) 
072A100005000100FF7FFF7FFF7F04050000F57F 

a. How many nodes are reported by the message? 

b. What is the transmitting node's address? 

c. What is the address of the first node reported in this 
message? 
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PROTOCOL LAB SOLUTIONS 

1. Ethernet Data 



Work out what the node addresses would look like for 
SUPER and HARDY. 



Area Node No. 

6 bits 10 bits 

230 = E6 (hex) and 149 = 95 (hex) 

Thus SUPER would be 08E6 and HARDY would be 0895. 

Break up the Ethernet Protocol 

Ethernet Header 

Source Addr: 0895000400AA Dest. Addr: 08E6000400AA 

Protocol Type: 0360 DNA Frame Chk Seq: 44B89BC0 

Data 

0400AA00 00085600 0400AA00 0026001C 

000082D1 0817&416 04000000 00089500 

0000 00000000 00000000 00000000 

The interpretation should be as follows: 

Dest. Host: 08E6000400AA 

In Ethernet notation, this would be AA-00-04-00-E6-08 . 
From the handout, the number AA-00-04-00 is always 
added to the 16-bit node address. The 16-bit node 
addresses should be interpreted as 08E6 (SUPER). 
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Source Hostt 0895000400AA 

From similar reasoning, the source host would be 0895 
or node HARDY. 

Protocol Type: 0360 DNA 

Frame Chk Seqs 44B89BC0 (This is a 32-bit CRC check) 
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PROTOCOL LAB SOLUTIONS 

Data 



001C 



0400AA00 0008E600 0400AA00 0026001C 

000082D1 08176416 04000000 00089500 

0000 00000000 00000000 00000000 

This is the message length field (28 bytes) 



26 


Bits 

Bit 

Bit 


i 0-1 
2 
5 


Message type 2 
Direct from end 
Intra-NI packet 


0000 






Reserved 


AA000400E608 






Destination ID 


0000 






Reserved 


AA0004009508 






Source ID 


00 






Reserved 


00 






Visit count = 


0000 






Reserved 



(There are 24 bytes of transport header on Ethernet.) 



04 

6416 
0817 
82D1 



NSP data ack 

Dest. logical address 

Source logical address 

Acknum 



(Note that there are a total of 28 bytes in the message) 
0000.... Padding with up to 46 bytes 
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PROTOCOL LAB SOLUTIONS 

2. DDCMP Exercises 

A. DDCMP Initialization 

The DDCMP initialization sequence is this message. 
The following is a breakdown of the various fields 
(refer to your DDCMP specification for details). 



FIELD NAME 

ENQ 

TYPE 



FLAG 

RESPONSE NO. 
TRANSMIT NO. 
STATION NO. 
BLOCK CHECK 



HEX CONTENT INTERPRETATION 



05 
06 



CO 

00 
00 
01 
7595 



DDCMP CONTROL MESSAGE 

DDCMP START MESSAGE 
(1 - ACK 

2 - NAK 

3 - REP 

6 - STRT 

7 - STACK) 

SELECT - 1 
QSYNC ■ 1 

NOT USED IN CONTROL MESSAGES 

NOT USED IN CONTROL MESSAGES 

ALWAYS 01 ON PT-TO-PT LINKS 

CYCLIC REDUNDANCY CHECK 



B. NSP Data Acknowledgement Message 

This message is sent in response to the NSP connect ACK and 
NSP connect confirm messages. It has a routing header. 



FIELD NAME HEX CONTENT INTERPRETATION 
DDCMP HEADER 810DC0050601DDB1 
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PROTOCOL LAB SOLUTIONS 



ROUTE HEADER 020204050401 



MSGFLG 


04 


DSTADDR 


010B 


SRCADDR 


0108 


ACKNUM 


0180 



02 » ROUTING DATA MESSAGE 
0402 = SRC NODE ADDRESS 1.2 
0504 = DST NODE ADDRESS 1.5 
01 = VISIT COUNT FIELD 

NSP DATA ACKNOWLEDGEMENT 

DESTINATION LOGICAL LINK ADDRESS 

SOURCE LOGICAL LINK ADDRESS 

THE FORMAT FOR THIS WOULD BE: 



15 14 12 
1 QUAL 



11 
NUMBER 



THUS 8001 MEANS ACKNOWLEDGE 
NSP MESSAGE 1 



BLOCK CHECK 



86D3 



C. NSP Data Message 

This is the message containing user data. 



FIELD NAME 
DDCMP HEADER 
ROUTE HEADER 
MSGFLG 



HEX CONTENT INTERPRETATION 

8122C0060801FC17 

020400050000 



60 



DSTADDR 


010B 


SRCADDR 


0108 


SEGNUM 


0100 


DATA 


HELLl 


BLOCK CHECK 


0612 



SINGLE SEGMENT MESSAGE 
BEGINNING OF SESSION CONTROL 
MESSAGE AND END OF SESSION 
CONTROL MESSAGE BOTH EQUAL 1 

DESTINATION LOGICAL LINK ADDRESS 

SOURCE LOGICAL LINK ADDRESS 

SEGNUM - 1 - NO DELAYED ACK 



HELLO, THIS IS A TEST 
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PROTOCOL LAB SOLUTIONS 

D. NSP Data Acknowledgment Message 

This message acknowledges the receipt of a good message. 

ITBNT INTERPRETATION 
810BCOOBOAO1B972 

140000 

NSP DATA ACKNOWLEDGMENT MESSAGE 
DESTINATION LOGICAL LINK ADDRESS 
SOURCE LOGICAL LINK ADRESS 
ACKNOWLEDGE DATA MESSAGE 1 



FIELD NAME 


HEX i 


DDCMP HEADER 


810D 


ROUTE HEADER 


02051 


MSGFLG 


04 


DSTADDR 


0108 


SRCADDR 


010B 


ACKNUM 


0180 


BLOCK CHECK 


9F45 
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PROTOCOL LAB SOLUTIONS 

3. Protocol is: 

a. The DNA interface between adjacent layers at the same node 

b. A special message sent over the network to control data 
transmission 

c. The DNA interface between the same layers in different 
nodes. 

4. What type of delivery service does the Ethernet Data Link 
offer to its clients? 

a. Positive acknowlegement with automatic retransmissions 

b. Worst-Case control with automatic retransmissions 

c. Best-Effort with indefinite automatic retransmissions if 
collisions are detected 

d. Best-Effort with no more than 16 automatic retransmissions 
if collisions are detected 

5. Etherent data messages can send between 46 and 1500 
bytes of client data. 

6. For the following Segmented Routing Message: 

072A100005000100FF7FFF7FFF7F04050000F57F 

a. How many nodes are reported by the message? 

5 

b. What is the transmitting node's address? 

102A - 1.6 

c. What is the address of the first node reported in this 
message? 

1.1 (Note that the area bits are cleared) 
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SDA LAB EXERCISES 

This analysis will be done on a crash dump taken on a VAX 750 with 
3 MB of memory. The node was a Phase IV routing node, running VMS 

Version 4.4. 

The following information is a list of DCL and NCP commands taken 
before the crash. 



NCP> SHOW KNOWN NODES SUMMARY 

Known Node Volatile Summary as of 3-SEP-1986 21:23:15 

Executor node = 1.2 (THUD) 



State 
Identification 



= on 

- VAX 750 - Standalone System 



Node 


State 


Active 
Links 


Delay 


Circuit 


Next node 


1.1 (SPLASH) 


reachable 


4 


1 


UNA-0 


1.1 (SPLASH) 


1.3 (ZIP) 


reachable 






UNA-0 


1.3 (ZIP) 


1.4 (BAROOM) 


reachable 






UNA-0 


1.4 (BAROOM) 


1.5 (CLICK) 


reachable 






UNA-0 


1.5 (CLICK) 


1.6 (DRIP) 


unreachable 










1.10 (NOISES) 


reachable 


1 


1 


UNA-0 


1.4 (BAROOM) 


1.13 (FIZZ) 


unreachable 










1.14 (SNAP) 


unreachable 










1.15 (POOF) 


unreachable 
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$ SHOW NETWORK 

VAX/VMS Network status for local node 1.2 THUD on 3-SEP-1986 21(22:12.98 



Node 


Links 


Cost 


Hops 


Next Hop 


to Node 




1.2 THUD 











(Local) 


-> 1.2 


THUD 


1 . 1 SPLASH 


3 






UNA-0 


-> 1.1 


SPLASH 


1.3 ZIP 









UNA-0 


-> 1.3 


ZIP 


1 . 4 BAROOM 









UNA-0 


-> 1,4 


BAROOM 


1.5 CLICK 









UNA-0 


-> 1.5 


CLICK 


1.10 NOISES 


1 






UNA-0 


-> 1.4 


BAROOM 



Total of 6 nodes. 



$ SHOW SYSTEM 

VAX/VMS V4.4 on node 
Pid Process Name 

00000080 NULL 

00000081 SWAPPER 

00000084 ERRFMT 

00000085 OPCOM 

00000086 JOB CONTROL 

00000089 SYMBIONT 0001 
0000008E DBMS MONITOR 

00000090 NETACP 

00000091 EVL 

00000092 ACMS_SWL 

00000093 REMACP 

00000094 Scott 

00000095 FALJ.026 

00000096 SCOTT 

00000097 PHONE_1034 
0000009B NET3 
0000009C Commuter 

$ SHOW USERS 



THUD 3-SEP 
State P 
COM 
HIB 
HIB 
LEF 
HIB 
HIB 
LEP 
HIB 
HIB 
HIB 
HIB 
LEF 
LEF 
LEF 
LEF 
LEF 
CUR 



-1986 21:22:19. 
ri I/O 





16 

8 

8 

8 

4 

10 

10 

6 

9 

9 







28 

70 

532 
12 
17 

111 
43 
12 
23 



8 302 
6 144 



373 
94 
59 



4 141 



00: 
00: 
00: 
00: 
00: 
00: 
00: 
00: 
00: 
00: 
00: 
00: 
00: 
00: 
00: 
00: 
00: 



97 Uptime 

CPU Page 

13:12.79 

00:01.02 

00:00.53 

00:01.45 

00:06.83 

00:00.67 

00:00.97 

00:04.87 

00:02.08 

00:00.56 

00:00.31 

00:16.37 

00:05.64 

00:08.27 

00:03.49 

00:02.17 

00:15.62 



00: 

fits 





70 

184 

181 

152 

216 

313 

586 

137 

74 

800 

883 

1000 

589 

354 

903 



17:47 

Ph. Mem 





89 

46 

302 

36 

314 

236 

30 N 
200 
40 
563 
150 
176 

150 N 
177 
280 



VAX/VMS Interactive Users 
Total number of interactive users ■ 



Username 

NET3 

SCOTT 

SCOTT 

SCOTT 



Process Name 

NET3 

Scott 

SCOTT 

Commuter 



PID 
0000009B 
00000094 
00000096 
0000009C 



3-SEP-1986 21:22:26.63 

4 

Terminal 

RTAl: 

LTA1: 

LTA2: 

LTA3: 



N 
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$ SHOW MEMORY/PHYSICAL/POOL/FULL 



System Memory Resources on 

Physical Memory Usage (pages): Total 

Main Memory (3.00Mb) 6144 

Small Packet (SRP) Lookaside List 

Current Total Size 

Initial Size (SRPCOUNT) 

Maximum Size (SRPCOUNTV) 

Free Space 

Space in Use 

Packet Size/Upper Bound (SRPSIZE 

Lower Bound on Allocation 
I/O Request Packet (IRP) Lookaside L 

Current Total Size 

Initial Size (IRPCOUNT) 

Maximum Size (IRPCOUNTV) 

Free Space 

Space in Use 

Packet Size/Upper Bound (fixed) 

Lower Bound on Allocation 
Large Packet (LRP) Lookaside List 

Current Total Size 

Initial Size (LRPCOUNT) 

Maximum Size (LRPCOUNTV) 

Free Space 

Space in Use 

Packet Size/Upper Bound (LRPSIZE 

Lower Bound on Allocation 
Nonpaged Dynamic Memory 

Current Size (bytes) 

Initial Size (NPAGEDYN) 

Maximum Size (NPAGEVIR) 

Free Space (bytes) 

Size of Largest Block 

Number of Free Blocks 
Paged Dynamic Memory 

Current Size (PAGEDYN) 

Free Space (bytes) 

Size of Largest Block 

Number of Free Blocks 



3-SEP-1986 21:22:41.25 

Free In use Modified 
928 4804 412 



Packets 
746 
746 
2984 
413 
333 



ist Packets 
520 
520 
2080 
294 
226 



Packets 
21 



+ 80) 



6 
60 

9 
12 



Bytes 

71616 

71616 

286464 

39648 

31968 

96 

32 

Bytes 

108160 

108160 

432640 

61152 

47008 

208 

97 

Bytes 

33264 

9504 

95040 

14256 

19008 

1584 

1088 



287744 
287744 
863744 
114176 
107072 
19 



253952 

28624 

26912 

23 



Current Total Size (pages) 
Initial Size (pages) 
Maximum Size (pages) 
Space in Use (bytes) 
Size of Smallest Block 
Free Blocks LEQU 32 Bytes 

Current Total Size (pages) 
Space in Use (bytes) 
Size of Smallest Block 
Free Blocks LEQU 32 Bytes 



Pages 
140 
140 
560 



Pages 
212 
212 
845 



Pages 

65 

19 

186 



562 

562 

1687 

173568 

16 

3 

496 

225328 

16 

17 
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NCP> SHOW EXEC CHARACTERISTICS 

Node Volatile Characteristics as of 3-SEP-1986 21:22:56 



Executor node = 1.2 (THUD) 

Identification » 

Management version = 

Incoming timer « 

Outgoing timer = 

NSP version = 

Maximum links = 

Delay factor a 

Delay weight - 

Inactivity timer = 

Retransmit factor = 

Routing version - 

Type ■ 

Routing timer = 

Broadcast routing timer - 

Maximum address = 

Maximum circuits - 

Maximum cost a 

Maximum hops = 

Maximum visits = 

Maximum area = 
Max broadcast nonrouters - 

Max broadcast routers = 

Area maximum cost = 

Area maximum hops = 

Maximum buffers s 

Buffer size = 

Nonprivileged user id ■ 

Default access = 

Pipeline quota = 

Default proxy access - 

Alias maximum links = 



VAX 750 - Standalone System 

V4.0.0 

45 

45 

V4.0.0 

32 

80 

5 

60 

10 

V2.0.0 

routing IV 

600 

180 

15 

10 

10 

5 

10 

63 

64 

32 

1022 

30 

15 

576 

DECNET 

incoming and outgoing 

5000 

incoming and outgoing 

32 
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NCP> SHOW ACTIVE CIRCUITS CHARACTERISTICS 

Active Circuit Volatile Characteristics as of 3-SEP-1986 21:23:25 

Circuit = DMC-0 



State 

Service 

Cost 

Hello timer 

Verification 

Adjacent node 

Listen timer 



= on 

= enabled 

= 2 

= 15 

- disabled 

= 1.1 (SPLASH) 

= 30 



Circuit = UNA-0 

State 

Service 

Designated router 

Cost 

Router priority 

Hello timer 

Type 

Adjacent node 

Listen timer 



= on 

= enabled 

= 1.1 (SPLASH) 

= 1 

= 64 

= 15 

= Ethernet 

= 1.1 (SPLASH) 

= 45 



Circuit = UNA-0 

Adjacent node 
Listen timer 



= 1.4 (BAROOM) 
= 45 



Circuit = UNA-0 

Adjacent node 
Listen timer 



= 1.3 (ZIP) 

- 45 



Circuit = UNA-0 

Adjacent node 
Listen timer 



= 1.5 (CLICK) 
= 45 
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NCP> SHOW KNOWN LINKS STATUS 

Known Link Volatile Summary as of 3-SEP-1986 21:23:37 

Link Node PID Process Remote link Remote user 



State 



1026 


1.1 (SPLASH) 


00000095 


FAL_1026 


3094 


NET9 


run 


1033 


1.1 (SPLASH) 


00000094 


Scott 


4128 


PHONE 


run 


1038 


1.1 (SPLASH) 


00000093 


RBMACP 


4136 


SCOTT 


run 


1039 


1.1 (SPLASH) 


00000093 


REMACP 


3114 


SUE 


run 


1034 


1.10 (NOISES) 


00000097 


PHONE 1034 


2817 


VICKI 


run 



NCP> TELL SPLASH SHOW KNOW LINKS STATUS 

Known Link Volatile Summary as of 3-SEP-1986 21:23:46 

Link Node PID Process Remote link Remote user State 



3094 


1.2 


(THUD) 


20600288 


NET9 


1026 


FAL 


run 


4128 


1.2 


(THUD) 


2060030D 


PHONE 4128 


1033 


SCOTT 


run 


4136 


1.2 


(THUD) 


2060030F 


SCOTT 


1038 


CTERM 


run 


3114 


1.2 


(THUD) 


2060027F 


sur la plage. 


..1039 


CTERM 


run 


4139 


1.2 


(THUD) 


2060028A 


NML 4139 


1040 


SCOTT 


run 


2817 


1.2 


(THUD) 


2060030B 


VICKI 


1034 


PHONE 


run 
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NCP> SHOW KNOW NODES COUNTERS 

Known Node Counters as of 3-SEP-1986 21:24:21 

Executor node = 1.2 (THUD) 

6 Maximum logical links active 

Aged packet loss 

Node unreachable packet loss 

Node out-of- range packet loss 

Oversized packet loss 

Packet format error 

Partial routing update loss 

Verification reject 

Remote node = 1.1 (SPLASH) 

725 Seconds since last zeroed 

8709 Bytes received 

15719 Bytes sent 

287 Messages received 

310 Messages sent 

6 Connects received 
10 Connects sent 

7 Response timeouts 

Received connect resource errors 

Remote node = 1.3 (ZIP) 
No information available 

Remote node = 1.4 (BAROOM) 
No information available 

Remote node = 1.5 (CLICK) 
No information available 

Remote node = 1.6 (DRIP) 
No information available 
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Remote node = 1.10 (NOISES) 

437 Seconds since last zeroed 

139 Bytes received 

1 Bytes sent 

32 Messages received 

28 Messages sent 

1 Connects received 

Connects sent 

Response timeouts 

Received connect resource errors 



Remote node ■ 1.13 (FIZZ) 
No information available 

Remote node - 1.14 (SNAP) 
No information available 

Remote node = 1.15 (POOF) 
No information available 
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SDA LAB SOLUTIONS 

1. Invoke SDA with the file DECNETINT$SOLN:SDALAB.DUMP 

$ ANALYZE/CRASH_DUMP DECNETINT$SOLN:SDALAB.DOMP 

NOTE 

Ignore the message regarding the shortage of 
physical memory pages contained in the dump 
file. It is less than that on the current 
system, but is all the pages from the crashed 
system. 

2. Read in the system and network definition files. 

SDA> READ SYS$ SYSTEM :SYSDEF 
SDA> READ SYS$ SYSTEM sNETDEF 

3. Set the output to go to a file and issue the following 
commands : 

SDA> SET LOG SYS$ LOGIN: SDA. LOG 

a. Issue the coiomand to look at the processes around at the 
time the crash was taken and the image they were 

executing: 

SDA> SHOW SUMMARY/IMAGE 

b. Issue the following command to look at pool: 
SDA> SHOW POOL/SUMMARY 

c. Isue the command to look at all NETn, MBAn, and RTAn 
devices: 

SDA> SHOW DEVICE NET 
SDA> SHOW DEVICE MB 
SDA> SHOW DEVICE RT 

d. Issue the command to look at network hardware devices: 

SDA> SHOW DEVICE XE 
SDA> SHOW DEVICE XM 
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SDA LAB SOLUTIONS 

e. Set the output back to the terminal and print the file you 
created: 

SDA> SET NOLOG 

SDA> SPAWN/NOWAIT PRINT/NOTIFY/NOFEED SYS$LOGIN:SDA.LOG 

4. Examine the output 

a. Track down what process is associated with what NETn 
device. 

Use the process ID and the UIC. To look at a process in 
more detail, issue SDA> SHOW PROCESS/INDEX=nn 

(Where nn is the index number under the SHOW SUMMARY 
command ) 

b. Find a connection between a NETn device and a mailbox. 

Match a MBA address from the NETn device with the UCB 
address of the MBAn device. 

c. Find the address of the RCB (VCB of each NETn device). 

5. Continue the data structures examination in SDA. You may send 
the output to a file or examine these structures on line. 

6. FORMAT a UCB of one of the NETn devices. 

7. FORMAT and get a printed copy of the RCB. 

8. Look at the ADJ (RCB$L_PTR_ADJ) and get the index for several 
nodes. (Each index is a longword, so step through the table 
by 4 bytes.) 



EX- 24 



EXERCISES 

SDA LAB SOLUTIONS 

9. FORMAT the ADJ of a node and check the PNA (Physical Node 
Address) against the list of known nodes as displayed above. 

10. Examine the LPD table index (RCB$L_PTR_LPD) and look at an 
entry from ADJ$B_LPD INX for a circuit used to a node (Most of 
these will be ONA_0.T 

Note the COST, ROUTER PRIORITY, and BUFFER SIZE among the 
values in the LPD. 

11. Examine the Link Table (RCB$L_PTR_LTB) and look at one logical 
link. 

12. FORMAT this LTB and get the pointer to the XWB for that link. 

13. FORMAT and examine the XWB. 
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SDA LAB SOLUTIONS 

14. [OPTIONAL] Using ANALYZE/SYSTEM 

a. Establish a logical link with a node in the network, 

$ COPY/LOG file.dat node:: 
$ OPEN REMPILE node: : file.dat 



NOTE 

You may want to establish the link with 
your own node and examine both ends of the 
link. 

You will be the source process talking to a FAL process 
(on node or the local node). 

b. Issue the following NCP command and print out the file. 

$ MCR NCP SHOW KNOWN LINKS STATUS TO LINKS.DAT 

$ MCR NCP TELL node SHOW KNOW LINKS STASTUS TO LINKS.DAT 

c. Examine the current system with the command 
ANALYZE/SYSTEM. 

d. Repeat enough of the above exercises so that you can trace 
down the structures related to your logical link. 
Information from the NCP display will match what you find 
in XWB$REMLINK, XWB$_LOCLNK, XWB$_REMNOD, XWB$_PID, and 
other fields. 
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v 



LISTING OF DECnet-VAX MODULES 
1 MODULES OF NETACP 



o 



W A. vt~ x 



N0O V^?^'X. f Vv 



1.1 NETTRN - Major NETACP Work Dispatching Loop 



WQE$RESET_TIM 

WQE$CANCEL_TIM 

WQE$TIMER_AST 

WQE$INSQUE 

WQE$REMQUE 

WQE$ ALLOCATE 

WQE$ DEALLOCATE 

WQE$FORK 

NET$GETUTLBUF 

NET$BIN2ASC 

NET$JNX_CO 

Pool allocation 



- Cancel and reset timer 

- Cancel work timer 

- Work timer AST 

- insert WQE into work queue 

- Dispatch next work element 

- Allocate a work element 

- Deallocate a work element 

- Switch to work queue level 

- Get use of utility buffer 

- Convert binary to ASCII 

- Journalling routine 
routines 



1.2 NETCONECT - Routines to Process User Connect Requests 



NET$ CONNECT 

PRS_NCB 

PRS_NODE 

PRS_ACCESS 

PRS_OBJECT 

PRS_END 

DFLT_ACCESS 

GET_STR_NUM 

GET TOKEN 



- IO$_ACCESS $QIO Procesing 

- Parse Network Connect Block 

- Parse NCB nodename 

- Parse NCB access control fields 

- Parse NCB target task identifier 

- Parse the remainder of the NCB 

- Get default access control 

- Get next numeric token 

- Get next token 
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1.3 NETPROCRE - Process Creation Routines 



NET$PROC_XWB 

NET$CREATE_MBX 

NET$KILL_MBX 

NET$MBX_QIO 

NET$SET_MBX_AST 

NET$CONNECT_FAIL 

NET$SERVER_FAIL 

NET$SCAN_FOR_ZNA 

NET$RESEND_SERVER 

NET$STARTUP_OBJ 

NET$ STARTUP_OBJ_NAM 

NET$DELIVER_CI 

BUILD_NCB 

GET_PROC 

SEND_TO_SERVER 

CREATE_SPI 

GET_PR_NAM 

GET_PR_ZNA 

TELL_DRV 

UP CASE 



Process returned XWB 

Create ACP mailbox 

Delete ACP mailbox 

Issue mailbox read 

Process mailbox AST 

Notify NETDRIVER of failed link 

Notify NETDRIVER of terminated server 

Send pending connects to declared 

object 

Re-send initial connect to server 

Startup privileged process 

Startup process by name 

Process and Deliver Inbound Connect 

Build NCB for incoming connect 

Locate process to accept connect 

Send connect to waiting server 

Create SPI database entry 

Get name of object procedure 

Construct ZNA string for .an object 

Call NETDRIVER 

Upcase the LOGINOUT strings 



1.4 NETACPTRN - Control Network Local Node State Transition Routines 



MOUNT 

INIT_NETDRIVER 

CALL_NETDRIVER 

NET$DEC_TRANS 

DISMOUNT 

START_TIMER 

PROC_EVT 

MBX_NET_SHUT 

NET$DECR_MCOUNT 

NET$UPD_LOCAL 

NET$DECLARE_PSI 

UNDECLARE_PSI 

UPDATE_DATABASE 

BUILD_LTB 

BUILD_LPD 

BUILD_ADJ 

BUILD_NDC 

BUILD_OA 

BUILD_AOA 

COM BLD CO 



- Mount the NET device 

- Tell NETDRIVER to initialize 

- Call NETDRIVER entry point 

- Decrement transaction count 

- Dismount the NET device 

- Start up ACP activity timer 

- Process ACP event 

- Broadcast shutdown message 

- Decrement ACP mount count 

- Update local state 

- Declare ourselves as a PSI process 

- Remove PSI declaration 

- Update non-paged control blocks 

- Build logical link table 

- Build the LPD vector 

- Build the ADJ vector 

- Build the node counter vector 

- Build output adjacency vector 

- Build area output adjacency vector 

- Common build vector coroutine 
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1.5 NETCNF - Configuration Database Access Routines 



CNF$PRE_SHOW 

CNF$PRE_QIO 

CNF$DELETE 

CNF$ PURGE 

CNF$ INSERT 

CNF$COPY 

CNF$CLONE 

CNF$INIT 

CNF$KEY_SEARCH 

CNF$ SEARCH 

COMPARE 

CNF$GET_FIELD 

CNF$PUT_FIELD 

CNF$CLR_FIELD 

CNF$ VERIFY 

GET_RT_FIELD 

PUT_RT_FIELD 

GET DSC 



- Pre-SHOW processing 

- Pre-QIO processing 

- Delete a CNF entry 

- Drain CNF entries marked for delete 

- Insert/ replace a CNF entry 

- Copy a CNF to another 

- Compress a CNF entry 

- Initialize CNF entry 

- Search for selected CNFs 

- Search for CNFs by list of keys 

- Compare CNF against keys 

- Get field from CNF entry 

- Store field into CNF entry 

- Clear a CNF field 

- Check if field exists 

- Call action routine to get value 

- Call action routine to store value 

- Get descriptor of CNF field 



1.6 NETCLUSTR -Cluster Node Name Routines 



N ET$ S TART_AL I AS 
MRL_BLKAST 

READ_MRL_VALBL£ 

PLR_AST 

PDL_AST 

NET$STOP_ALIAS 

NET$ALIAS_XONOF 
RELEASEJLOCKS 

ADJUST NUMRTR 



- Initialize alias participation 

- Blocking AST for master registration 
lock 

- Put registration data in MRL value 
block 

- Blocking AST on participant's lock 
registration 

- Completion AST on participant 
departure lock 

- Disable this node's participation in 
alias 

- Perform flow control for alias 

- Release all locks to coordinate 
participation 

- Count the number of participating 
routers 
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1.7 NETCNFACT - Configuration Database Access Action Routines 



NET$SCAN_xxx 

NDIDEF_SCAN 

NET$SCAN_NDI 

NET$SCAN_AJI 

NET$SCAN_SDI 

NET$SCAN_ARI 

NET$SPCSCAN_XXX 

NET$SPCSCAN_NDI 

NET$PRE_QIO_xxx 

NET$SHOW_xxx 

NET$DEFAULT_XXX 

NET$DEFAULT_NDI 

NET$INSERT_LNI 

NDI_MARKER 

NET$INSERT_NDI 

NET$INSERT_OBI 

NET$INSERT_XXX 

CHK LOGIN_xxx 

NETfSPCINS_XXX 

NET$SPCINS_DEF 

NET$SPCINS_NDI 

NET$DELETE_XXX 

NET$REMOVE_XXX 

NET$REMOVE_DEF 

SCAN_XWB 

SUPPRESS_AREA 

NET$TEST_REACH 

NET$AREA_REACH 

NET$GET_LOC_STA 

NET$NDI_BY_ADD 

NET$LOCATE_NDI 

FMT CNT 



LOG COUNTERS 
LNI~PARAMETER ACTION ROUTINES 
NDI PARAMETER ACTION ROUTINES 
OBI PARAMETER ACTION ROUTINES 
ESI PARAMETER ACTION ROUTINES 
EFI PARAMETER ACTION ROUTINES 
LLI PARAMETER ACTION ROUTINES 
SPI PARAMETER ACTION ROUTINES 
AJI PARAMETER ACTION ROUTINES 
SDI PARAMETER ACTION ROUTINES 
ARI PARAMETER ACTION ROUTINES 
MOVE PARAMETER SUBROUTINES 



- Default database scanner 

- Default NDI database scanner 

- Scan NDI database 

- Scan AJI database 

- Scan SDI database 

- scan ARI database 

- Special database scan routines 

- Special scan of NDI database 

- Pre-QIO processing 

- Pre-SHOW processing 

- Apply default values 

- Apply default values to NDI CNF 

- Pre-insertion processing 

- Insert executor NDI marker 

- Pre-insertion processing 

- Pre-insertion processing 

- Pre-insertion processing 

- Check login string length 

- Special database insertion routines 

- Default database insertion routine 

- Insert NDI database into binary tree 

- Pre-delete processing 

- Process the remove request 

- Default processing of the remove request 

- Scan XWB list 

- Suppress area from node address 

- Test node reachability 

- Test area reachability 

- Get executor state 

- Find NDI CNF by node address 

- Find phantom or real NDI CNF 

- FORMAT COUNTERS 

- LOG ZERO COUNTER EVENT 
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1.8 NETCNFDLL - Datalink Database Action Routines 



NET$SCAN_xxx 

NET$PRE_QIO_xxx 

NET$SHOW_XXX 

JAM_CNF 

GET_PSI_xxx 

CLEAR_VOLATILE 

NET$DEFAULT_CRI 

NET$DEFAULT_PLI 

NET$INSERT_CRI 

CRI_TO_PSI 

NET$INSERT_PLI 

ALLOC_PLVEC 

NET$SET_QIOW 

PLI_TO_PSI 

SEND_TO_PSI 

NET$DELETE_CRI 

NET$DELETE_PLI 

NET$REMOVE_xxx 

CRI parameter act 

PLI parameter act 

BUILD_DEVBUF 

NET$CVT_NMA_INT 

TRAN_DEVNAM 

PRS_MNEMONIC 

PRS_DECIMAL 

DEV CNT QIO 



- Scan database 

- Pre-QIO processing 

- Pre- SHOW processing 

- Store driver values into CNF 

- Get current PSI parameter values 

- Clear list of volatile parameters 

- Apply default values 

- Apply default values 

- Pre-insertion processing 

- Send CRI parameters to PSIACP 

- Pre-insertion processing 

- Set up PLVEC entry for new line 

- Issue datalink SETMODE function 

- Send PLI parameters to PSIACP 

- Send control QIO to PSIACP 

- Pre-delete processing 

- Pre-delete processing 

- Pre-remove processing 
ion routines 
ion routines 

- Build DLLQIO buffer 

- Convert NMA to NFB code 

- Translate device name 

- Parse device mnemonic 

- Parse decimal number 

- Get device counters 
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1.9 NETDLLTRN - Routing and Datalink Control Layer Routines 



NET$INIT_ROUTING 

NET$DLLUPDLNI 

FORCE_FULL_DECISION • 

NET$DLL_ALL_OFF 

NET$DLL_OPR_SET 

ALLOC_LPD 

ALLOC_COSTHOPS 

DEAL_LPD 

CHECK_REQ_P ARAMS 

NET$DLL_X25_CALL 
NET$DLL_X25_RESET 
NET$DLL_RCV 
Received message pre- 

RCV_STR2 

RCV_STR3 

RCV_STR4 

RCV_VRF 

RCV_RHEL 

RCV_EHEL 

RCV_RT3 
RCV_RT4 
RCV ART 



Initialize routing database 

■ Process modified LNI parameters 
Force full decision algorithm 

• Turn off all circuits 

Process operator-generated event 

■ Allocate LPD 

• Allocate a cost/hops buffer 

• Deallocate LPD 

■ Check that required parameters are 
set 

• Process incoming X.25 call 

• X.25 reset detected 

• Process message received from driver 
■processing routines 

■ Received Phase II start message 

• Received Phase III start message 

• Received Phase IV start message 

• Received routing verification message 

■ Received Phase IV Router Hello 
message 

• Received Phase IV Endnode Hello 
message 

• Received Phase III routing message 
- Received Phase IV routing message 

• Area Routing message received 



Check for routing update loss 

Parse phase II/III/IV address 

SET_DLL_EVT - Schedule event transition 

NET$DLL_PRC_WQE - Process work queue element 

PROC_EVT - Process an event 

FIND_WQE_CTX - Find context for a new WQE 

Simple transition routines 



ACT_RCV_STR 

ADAPT_TO_PARTNER 

ACT_RCV_VRF 

ACT_RCV_RHEL 

ACT_ELECT 

ACT_RCV_EHEL 

ACT_RCV_RT 

UPDATE_MATRIX 

ACT_RCV_ART 

REQUEST_UPDATE 

UPDATE 

DECISION 

F I ND_PATH_TO_NODE 

AREA_DECISION 

FIN D_P ATH_TO_ARE A 

UPD_NEIGHBORS 

TIMER XRT 



- Received start message 

- Adapt to partner's node type 

- Received verification message 

- Received Router Hello message 

- Resolve election after waiting 

- Received Endnode Hello message 

- Receive routing message 

- Update the routing matrix 

- Receive area routing message 

- Request update of routing database 

- Update database and neighbors 

- Update forwarding database 

- Find least cost path to node 

- Update area forwarding database 

- Find least cost path to area 

- Schedule routing messages 

- Automatic routing update timer 
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Start automatic routing 

ENDNODE_DECISION 

ACT_ENT_MOP 

ACT_DLL_UP 

DLE-related state change 

ACT_RUN_DOWN 

ACT_SET_OPER 

ACT_TST_DL 

ACT_ENT_RUN 

ACT_BC_UP 

BRA_UP 

LOWEST_PRIO_BRA 

BEA UP 



update timer 

Endnode decision algorithm 

Enter MOP state 

Datalink has initialized 
s 

Run down a circuit 

Restart a "stalled" circuit 

Circuit acceptance algorithm 

Enter RUN state 

Broadcast datalink has initialized 

Set up new adjacency for BRA 

Find lowest priority BRA 

Set up new adjacency for BEA 



Error action routines 

EXIT_RUN_STATE 

ADJ_DOWN 

BRA_DOWN 

B(JILD_RTR_LIST 

ELECT_ROUTER 

ACT_QIO_SHUT 

ACT_QIO_STRT 

ACT_PVC_START 

ACT_X25_CALL 

CHK_CIRC_START 

TOGGLE_LINE 

ACT_XMT 

XMT_DALLY 

XMT_STR 

XMT_VRF 

XMT_RT 

XMT_RT4 

XMT_ART 

CHK_IO 

NET$DLL_QIO_CO 

SET_IOTIM 

RESET_CHAN 

NET$GET_LPD_CRI 

NET$ADJ_LPD_CRI 

NET$LOCATE_LPD 

NET$FIND_LPD 

NET$FIND_ADJ 

NET$GET_PLVECLPD 

TEST_SWITCH_LINE 

SCHED_SWITCH_WQE 

K I LL_SWI TCHED_DATABAS E 
TELL NETDRIVER 



for RUN state 

- Exit the RUN state 

- Mark adjacency as shutdown 

- Mark BRA down 

- Rebuild NI router/state list 

- Elect designated router 

- Shut down the datalink 

- Start the datalink 

- Start an X.25 PVC in multiple 
steps 

- Accept incoming X.25 call 

- Check if circuit can be started 

- Shut down and start up line 

- Transmit pending messages 

- Dally before sending start message 

- Transmit start message 

- Transmit verification message 

- Transmit a routing message 

- Transmit a Phase IV routing 
message 

- Transmit a Phase IV area routing 
message 

- Check for multiple transmits 

- Common QIO routine 

- Set I/O timer 

- Cancel all device I/O 

- Locate CNF given LPD index 

- Locate CNF given ADJ index 

- Locate LPD given CNF 

- Find LPD given LPD index 

- Find LPD and ADJ given ADJ index 

- Find next active LPD 

- See if this line is SWITCH ENABLE 

- Schedule KILL_SWITCHED_DATABASE 
routine 

- Dissolve switched circuit database 

- Inform NETDRIVER of an event 
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1.10 NETCTLALL - Process ACP Control QIO Routines 

DISPATCHING 

Declare Name or Object 

Declare server process available for new connect 

Cancel I/O 

CTL_DATABASE - Process database QIOs 

GET P2_KEY - Get next P2 value 

PROCESS_CNF - Process each CNF block 

1.11 NETEVTLOG - Process Event Logging Needs Routines 

Event timer action routine 

Internal inbound raw event processing 

Inbound raw event processing 

STARTUP_EVL - Start EVL process 

Event logging database changes 

Outbound raw event processing 

NET$SET_CTR_TIMER - Reset automatic counter timer 

1.12 NETGETLIN - Check for DECnet License Routines 

Check if DECnet license installed 

Routing software key 

Endnode software key 

MORE ROUTINES TO CHECK LICENSE 

1.13 NETCONFIG - Local Configuration Database 

1.14 NETOPCOM - Operator Communications Routines 

NETWORK OPERATOR MESSAGE FORMATTING 

1.15 NETTREE - Subroutines for Processing Binary Trees 

1.16 NETDEFS - Various NETACP Symbol Definitions 
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1.17 NETDLE - NETACP DLE Processing Routines 



DLE$ DISPATCH 
DLE$ ACCESS 
DLE$LPD_STATUS 
BC_ACCESS 

DLE$SETMODE 

DLE$DEACCESS 

LEAVE_MOP_STATE 

DLE$ CANCEL 

DLE$BC_UP 

DLE$BC_DOWN 

INIT_UNSOL_CHAN 

ISSUE_NI_READ 

RCV_DLE_MSG 

DLE$MOP_REQUEST 

STARTUP_MOM 

ATTACH_UNSOL_MSG 

DLE$PRC EXIT 



- Dispatch newly received DLE IRP 

- Handle IO$_ACCESS function 

- Check completion of MOP transition 

- Handle DLE access to broadcast 
circuit 

- Process IO$_SETMODE request 

- Process IO$_DEACCESS request 

- Leave MOP state 

- Process DLE cancel request 

- Initialize DLE on broadcast circuit 

- Clean up DLE on broadcast circuit 

- Initialize channel for unsolicited 
messages 

- Issue read request to NI driver 

- Receive unsolicited DLE message 

- Partner has requested MOP mode 

- Start MOM process 

- Attach unsolicited message 

- Handle MOM process termination 



1.18 NETLLICNT - Node and Logical Link Counter Support Routines 



NET$INIT_NDCOU 
NET$ ACQU I RE_NDC.OU 
NET$ RELEASE_NDCOU 
NET$ FLUSH_LLI_CNT 
NET$ READ_LLI_CNT 
NET$READ_NDI_CNT 
COPY_NDC 
ADD_NDC 
ADD_NDC_TEMP 

SUBJJDC 
LOG_NDCOU 
GET_HASH_ADDR 
NET$ LOOKUP NDCOO 



- Initialize NDC queues 

- Acquire Node Counter block 

- Release claim on NDCOU block 

- Flush logical-link counters 

- Read logical-link counters 

- Read node counters 

- Copy NDC counters 

- Add NDC counters in NDC format 

- Add NDC counters and copy to temp 
area 

- Subtract NDC counters in NDC format 

- Log NDC counters 

- Get the table entry address 

- Find NDCOU in Hash Table 
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2 MODULES OF NETDRIVER 



2.1 NETDRVSES - DECnet Session Control Module for NETDRIVER 



NET$AZ_DR_TABLE 

NET$FORK 

NET$END_EVENT 

NET$COMPLEX_EV 
NET$PRE_EMPT 

NET$ EVENT 

NET$SCH_MSG 

ACT$NOP 

ACT$BUG 

ACT$LOG 

ACT$NOLINK 

ACT$SSABORT 

NET$STARTIO 

NET$FDT_SETMODE 

NET$FDT_CONTROL 

NET$ CONTROL 

NET$FDT_ACCESS 

NET$ACCESS 

ACT$INITIATE 

ACT$CONFRIM 

NET$CMPL_ACC 

ACT$ENT_RUN 

NET$ FDT_DEACCESS 

NET$DEACCESS 

CLEANUP_ACCESS 

NET$ CANCEL 

NET$PURG_RUN 

NET$ACP_COMM 

NET$SEND_CS_MBX 

NET$SEND_MBX 

NET$CREATE_XWB 

XWB_LOCLNK 

NET$XWB_LOCLNK 

NET$RET_SLOT 

NET$QUE_XWB 

NET$ DRAIN_FREE_CXB 

NET$ALONPGD_Z 

NET$ALONONPAGED 

NET$ DEALLOCATE 

NET$MOV_TO_XWB 

NET$MOV_CSTR 

NET$MOV_USTR 

NET$POST 10 



- Disconnect Reason Code Mapping 

- Fork the XWB to do new work 

- Abort current event without changing 
state 

- Change state and process new event 

- Process new event without changing 
state 

- Event dispatcher 

- Schedule message transmission 

- Null action routine 

- BUG_CHECK action routine 

- Log-event action routine 

- Report "SS$_FILNOTACC" 

- Abort QIO since link was disconnected 

- Start I/O operation 

- Process I0$_SETM0DE request 

- I0$_ACPC0NTR0L FDT processing 

- I0$_ACPC0NTR0L " start io" processing 

- I0$_ACCESS FDT processing 

- I0$_ACCESS " start io" processing 

- Connect Initiate action routine 

- Connect Confirm action routine 

- Complete I0$_ACCESS, fill in window 

- Enter RUN state action routine 

- IO$_DEACCESS FDT processing 

- IO$_DEACCESS " start io" processing 

- Clean up XWB for terminated I0$_ACCESS 

- Cancel I/O routine 

- Clean up XWB to exit RUN state 

- Entry for ACP communication 

- Send counted string to mailbox 

- Co- routine to send mailbox message 

- Create XWB for logical-link 

- Get XWB via local link number 

- Get XWB via local link number 

- Return logical-link XWB slot if done 

- Queue XWB to NETACP's AQB 

- Drain CXB free queue 

- Allocate and zero from system pool 

- Allocate from system pool 

- Deallocate non-paged pool 

- Move counted string to XWB$B_DATA 

- Move counted string with count field 

- Move counted string without count 
field 

- Send IRP to C0M$P0ST 
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2.2 NETDRVNSP - DECnet NSP Module for NETDRIVER 



NET$SETUP_RUN 

NET$ALTENTRY 

NET$FDT_RCV 

NET$FDT_XMT 

NET$UNSOL_INTR 

ACT$RTS_NLT 

ACT$RCV_CC 
ACT$RCV_CA 
ACT$RCV_CI 

PRS_CHR 

ACT$RCV_RTS 

ACT$RCV_DX 

ACT$ ABORT 

ACT$CANLNK 

ACT$RCV_DTACK 

ACT$RCV_LIACK 

NET$PIG_ACK 

PROC_DTACK 

PROC_LIACK 

NET$ACK_XMT_SEGS 

ACT$RCV_LI 

CHK_INT_AVL 

SHRINK_XPW 

NEW_DATA_FLOW 

CALC_HXS . . . 

ACT$RCV_DATA 

CLONE_RCV_CXB 

NSP$SOLICIT 

BLD_DISPATCH 

BLD_CD 

BLD_CI 

BLD_CA 

BLD_CC 

BLD_DI 

BLD_DC 

BLD_LIACK 

BLD_DTACK 

BLD_LI 

BLD_DAT 

GET_XMT_CXB 

GET_XMT_BUF 

NET$IO STATUS 



- Set up XWB for the RUN state 

- Driver alternate entry point 

- Process IO$_READxBLK requests 

- Process IO$_WRITExBLK requests 

- Receive from Transport layer 

- Return to sender as "no-link- 
terminate" 

- Respond to a received Connect Confirm 

- Respond to Connect Acknowledge 

- Process received Connect Initiate 
message 

- Get characteristics from Connect 
message 

- Receive CI message - "returned to 
sender" 

- Receive DI/DC message 

- Disconnect or abort a link 

- Disconnect link due to user's $CANCEL 

- DATA ACK message processing 

- INT/LI ACK message processing 

- Common piggy-backed ACK processing 

- Process of DATA ACK 

- Process INT/LS ACK 

- ACK Xmt Segs, Complete User Xmt IRPs 

- Receive INT/LS message 

- Conditionally set XWB$V_FLG_IAVL 

- Shrink the DATA transmit-packet-window 

- React to flow control msg 

- Calc 'highest xmt seg sendable' 

- Process received DATA message 

- Clone a copy of a received CXB 

- Solicit permission to transmit 

- Dispatch to build message 

- Build Connect/Disconnect messages 

- Build a CI msg from XWB contents 
CA msg from XWB contents 
CC msg from XWB contents 
DI msg from XWB contents 
DC msg from XWB contents 
INT/LS ACK message 
DATA ACK message 

- Build INT/LS message 

- Build DATA message 

- Get xmt CXB while in FDT context 

- Get xmt buffer while in fork context 

- Receive xmit status from Transport 
layer 



Build 


a 


Build 


a 


Build 


a 


Build 


A 


Build 


a 


Build 


a 
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NET$CCS_IOSTAT 

NET$TIMER 
TIMED SEG ACKED 



- Receive xmit status for Phase II CC 
message 

- Process NETDRIVER clock tick 

- Timed segment has been ACKed 



2.3 NETDRVXPT - NETDRIVER Transport (Routing) Layer Routines 



TR$ UPDATE 
TR$KILL_LOC_LPD 
TR$TIMER 
TR$SOLICIT 

TR$DENY 

TR$GRANT 

TR$TEST_REACH 

TR$GET_ADJ 

TR$RCV_DIO_DATA 

TR$ RCV_BIO_DATA 

RCV_DIO_BIO 

DISP_RCV_MSG 

TR_RTHDR 

TR_ECL 

Packet Errors 

TR_RTHRU 

FINISH_XMT_HDR 

UPDATE_CACHE 

TR$RTRN_XMT_RTH 

TR$RTRN_XMT_ECL 

TR$ RTRN_XMT_TLK 

TR_RTRN_IRP 

TR LPD_DOWN 

TR?GIVE_TO_ACP 

TR$QUE_WQE_AQB 

TR$QUE_IRP_AQB 

TR$LOC_DLL_XMT 

TR$LOC_DLL_RCV 

TR$ADJUST_IRP 

TR$ALLOC_IRP 

TR$ALLOCATE 

TR FILL JNX 



- Initiate receive sequence on data link 

- Attempt to shut down local LPD 

- Process Transport layer clock tick 

- Process ECL request to xmit into the 
net 

- Deny solicitor permission to transmit 

- Grant solicitor permission to transmit 

- Check if node is reachable 

- Get output ADJ and LPD 

- Rev Direct I/O from datalink layer 

- Rev Buffered I/O from datalink layer 

- Common Receive IRP processing 

- Dispatch received message 

- Process received msg's route header 

- Pass received packet to ECL 

- Process miscellaneous packet errors 

- Process packet for route-thru 

- Finish building HDR and transmit it 

- Update the BC cache table 

- End-action routine for route-thru IRPs 

- End-action routine for ECL IRPs 

- End-action routine for TALKER IRPs 

- Recycle IRP Xmit IRP pool 

- Process "LPD down" event 

- ECL entry to queue a buffer to the ACP 

- Queue WQE to AQB 

- Queue "LPD down" IRP to AQB 

- "Local" datalink driver transmit 

- "Local" datalink driver receive 

- Adjust the number of IRPs in the pool 

- Allocate IRP 

- Allocate and initialize buffer 

- Conditionally fill journal record 
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2.4 NETDRVQRL - DECnet 'Quick Routing Layer' Module for NETDRIVER 



ORL$ SOLICIT 

QRL$DENY 
QRL$GRANT 
QRL$SETUP_CHAN 
QRL$ SETUP_RTHDR 
QRL$SETUP X IRP 



- Process ECL request to xrait into the 
net 

- Deny solicitor permission to transmit 

- Grant solicitor permission to transmit 

- Set up channel to specified node 

- Build route-header 

- Allocate, init, queue IRP 



3 NDDRIVER - DECnet DLE DRIVER MODULES 



DRIVER PROLOGUE TABLE 
DRIVER DISPATCH TABLE 
FUNCTION DECISION TABLE 



DLE $ START 10 

DLE$FDT_ACCESS 

DLE$ACCESS 

DLE$ FDT_DEACCESS 

DLE$DEACCESS 

DEALLOC_DWB 

RESTORE_QUOTA 

DLE$FDT_SETMODE 

SETMODE_ACPBUF 

GET_STATUS 

DLE$FDT_CONTROL 

DLE$ CONTROL 

DLE$CANCEL 

CANCEL_ALL 

DLE$LPD_DOWN 

DLE$FDT_RCV 

DLE$FDT_XMT 

DLE$FDT_RW 

DLE$FDT_BYTQUO 

DLE$XMT_MSG 

DLE$XMT_DONE 

INIT_RCV_IRP 

ISSUE_DLL_RCV 

DLE$RCV_MSG 

RCV_DONE 

UNIT_INIT 

DLE$ALONPGD_Z 

DLE$ALONONPAGED 



- Start I/O operation 

- IO$_ACCESS FDT processing 

- IO$_ACCESS "startio" processing 

- IO$_DEACCESS FDT processing 

- IO$_DEACCESS "startio" processing 

- Deallocate DWB 

- Restore "access" quota 

- Process IO$_SETMODE request 

- Build SETMODE ACP complex buffer 

- Refresh DLE status flags for IOSB 

- I0$_ACPC0NTR0L FDT processing 

- I0$_ACPC0NTR0L " startio" processing 

- Cancel I/O routine 

- Cancel all outstanding I/O 

- The circuit has gone away 

- FDT for IO$_READxBLK requests 

- FDT for IO$_WRITExBLK requests 

- DLE FDT read/write processing 

- Get non-paged pool quota 

- Send message over direct-accessed 
circuit 

- Transmit I/O post-processing 

- Initialize datalink receive IRP 

- Issue datalink receive request 

- Receive a message from datalink 

- Complete User Receive IRP 

- Unit initialization 

- Allocate and zero from system pool 

- Allocate from system pool 
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